@kreiseck/kasseneck-api 1.0.0-rc.3 → 1.0.0-rc.4

package/CHANGELOG.md

@@ -147,6 +147,21 @@ an upgrade as long as `/v1` is served.
   again. `setMyRegisterDeviceSettings` takes `shortcuts` only as the whole map
   of known actions (as `posSettingsChanges` produces it): the server checks
   keys bound twice only within the map it receives.
+- **Money calls: an error envelope is not a rejection (1.0.0-rc.4).** On
+  `hobexPayApi`, `hobexRefundApi` and `stripeCaptureIntent` an error envelope
+  without a code is `outcome: 'unknown'`, and so is every code outside the
+  23 rejection codes, all raised before the provider is called: the
+  sign-in codes (`errorCodes.auth` without the seven of the partner
+  access), the edge codes `validation`, `not_found` and
+  `internal_translation_error`, the gates `module_inactive` and
+  `not_permitted`, and `route_missing`. `dialect_mismatch` and `response_translation_failed` (also
+  with `handled: false`) stay `'unknown'` there. rc.2 and rc.3 read an
+  envelope without a code as `'rejected'`, and the README called a retry
+  after `'rejected'` safe. Reason: the Hobex and Stripe handlers also answer
+  with a plain error message after the provider was called ("Error hobex
+  details", "Fehler beim Capturing"), so the card may be charged, the refund
+  paid or the payment captured. Same list as in the Dart twin
+  `kasseneck_api`.
 - **Strict validation before sending.** The 0.x payment fields
   (`paymentMethod`, `paymentMethodFromServer`, `creditCardProvider`,
   `cardPaymentId`, `cardPaymentData`) throw, also from plain JavaScript.

package/README.md

@@ -427,10 +427,9 @@ silently. For a layout option of 0.x the message names its English successor.
 ### `outcome: 'unknown'`: never retry, look it up
 
 `KasseneckApiError`, `KasseneckHttpError` and `KasseneckNetworkError` carry
-`outcome`. `'rejected'` means no operation with an effect is left open: no
-receipt was signed, nothing went to FinanzOnline and no money moved, so
-retrying the same request does not create a second receipt or charge (whether
-it helps depends on the code). `'unknown'` means the operation **may have been carried out**, for
+`outcome`. `'rejected'` means the server turned the request down; whether
+anything else is safe to do depends on the code, and on the money calls it
+is only set for the codes listed below. `'unknown'` means the operation **may have been carried out**, for
 `createReceipt` a signed receipt in the chain. Then never send it again: read
 the result back (`getReceipt`, `listMyReceipts`, the original of a
 cancellation) and continue from there. `isOutcomeUnknown(error)` covers all
@@ -448,13 +447,39 @@ three classes. The outcome is unknown for:
   5xx, and HTTP 200 with the `Kasseneck-Api-Version: v3` marker but an empty,
   non-JSON (also `text/html`) or status-less body (`KasseneckHttpError`,
   `reason` `empty-body`, `not-json` or `missing-status`). HTML without the
-  marker stays `route_missing` with `'rejected'`: no function saw the call.
+  marker stays `route_missing` with `'rejected'`: no function saw the call;
+- on the money calls: every error envelope **without a code**, and every
+  code that is not one of the rejection codes below. The Hobex and Stripe
+  handlers also answer with a plain error message after the provider was
+  called, so an envelope alone does not prove that nothing happened.
+
+On the money calls (`hobexPayApi`, `hobexRefundApi`, `stripeCaptureIntent`)
+`outcome` is `'rejected'` only for codes that are produced before the
+provider is called, taken from the `/v3` contract (`errorCodes`):
+
+- the sign-in codes (`errorCodes.auth` without the seven of the partner
+  access, which never applies to these calls), raised before the handler
+  goes on: `method_not_allowed`, `validation` (a required field is missing
+  or has the wrong type), `cashregister_token_missing`,
+  `cashregister_token_invalid`, `cashregister_not_found`,
+  `account_not_found`, `live_not_enabled`, `unauthorized`, `mfa_required`,
+  `user_verification_failed`, `admin_required`, `register_user_not_allowed`,
+  `register_user_no_business`, `register_user_not_found`, `user_disabled`,
+  `session_expired`, `cashregister_not_assigned`,
+  `session_other_cashregister`;
+- the edge codes that stop the call before the handler (`errorCodes.edge`):
+  `validation` (unknown fields), `not_found`, `internal_translation_error`;
+- the module and permission gates: `module_inactive`, `not_permitted`;
+- `route_missing` (set by the package: no function saw the call).
+
+`dialect_mismatch` and `response_translation_failed` (also with
+`handled: false`) stay `'unknown'` there: the handler may have run.
 
 On the money calls an unknown outcome means the card may have been charged,
 the refund may have gone through, the payment may have been captured. A
-rejection of `hobexRefund` throws a `KasseneckApiError` with its `code`; it
-never returns `false`, because a `false` on an unclear outcome invites a
-second refund.
+failed `hobexRefund` throws a `KasseneckApiError`; it never returns `false`,
+because a `false` on an unclear outcome invites a second refund. Even a
+`'rejected'` is no invitation to resend blindly: fix the cause first.
 
 **Never retry these six calls, and never put a retrying layer under the
 package.** A `fetch` passed in `options.fetch` (or a proxy or service worker in

package/dist/cjs/client/errors.d.ts

@@ -110,6 +110,34 @@ export declare function fehlerDetails(daten: unknown, geheimnisse: readonly stri
  * das Ergebnis nachlesen.
  */
 export type ErrorOutcome = 'unknown' | 'rejected';
+/**
+ * Codes, die auf einem Geldweg `outcome: 'rejected'` ergeben; jeder andere
+ * Code und eine Huelle ohne Code sind dort `'unknown'`. Aufgenommen ist nur,
+ * was entsteht, bevor das Backend den Zahlungsanbieter anspricht (Vertrag
+ * v3, `errorCodes`; dieselbe Liste wie `paymentCallRejectedCodes` im
+ * Dart-Zwilling):
+ *
+ * - `errorCodes.auth` ohne die sieben des Partner-Zugangs (18 Codes):
+ *   Anmeldung und Pruefung in `checkRequest` laufen vor jeder Zeile des
+ *   Handlers; `validation` heisst dort Pflichtfeld fehlt oder falscher Typ.
+ *   Der Partner-Zugang trifft diese `api_key`-Aufrufe mit Kassen-Token nie.
+ * - aus `errorCodes.edge`: `not_found` (unbekannter Endpunkt, HTTP 404) und
+ *   `internal_translation_error` (die Anfrage liess sich nicht uebersetzen,
+ *   es wurde nichts ausgefuehrt); `validation` des Rands (unbekannte Felder,
+ *   Rumpf ohne Objekt) steht schon oben.
+ * - `module_inactive` und `not_permitted`: das Modul- bzw. Rechte-Tor steht
+ *   ebenfalls vor dem Anbieter.
+ * - `route_missing` (vergibt das Paket): HTML ohne `/v3`-Kennzeichen, keine
+ *   Function hat den Aufruf gesehen.
+ *
+ * Nicht darin: `dialect_mismatch` (das Paket vergibt ihn auch, wenn ein Rand
+ * ohne `/v3` geantwortet hat, dessen Handler gelaufen sein kann) und
+ * `response_translation_failed` (der Handler lief; auch `handled: false`
+ * heisst nur, dass seine Antwort ein Fehler war, und der kann hinter dem
+ * Anbieteraufruf entstanden sein). Der Sammelfang der Handler ("Error hobex
+ * details", "Fehler beim Capturing") antwortet ohne Code.
+ */
+export declare const PAYMENT_CALL_REJECTED_CODES: readonly string[];
 /**
  * Codes, die das Paket selbst vergibt, nicht der Server: `route_missing`
  * (HTML statt Backend, der Aufruf kam nie an) und `response_unreadable`
@@ -146,7 +174,10 @@ export declare class KasseneckApiError extends Error {
      * `cancellation_outcome_unknown`, `response_unreadable` (Erfolg gemeldet,
      * Antwort eines Aufrufs mit Wirkung aber unlesbar) und
      * `response_translation_failed` (ausser mit `details.handled === false`);
-     * sonst `'rejected'`. Bei `'unknown'` nie wiederholen, sondern nachlesen.
+     * sonst `'rejected'`. Auf den Geldwegen (`hobexPayApi`, `hobexRefundApi`,
+     * `stripeCaptureIntent`) umgekehrt: `'rejected'` nur mit einem Code aus
+     * [PAYMENT_CALL_REJECTED_CODES], ohne Code und mit jedem anderen Code
+     * `'unknown'`. Bei `'unknown'` nie wiederholen, sondern nachlesen.
      */
     readonly outcome: ErrorOutcome;
     constructor(functionName: string, serverMessage: string, details?: Record<string, unknown>, code?: string);

package/dist/cjs/client/errors.js

@@ -73,7 +73,7 @@
  * als die Zusage.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.KasseneckValidationError = exports.KasseneckAuthError = exports.KasseneckNetworkError = exports.KasseneckHttpError = exports.KasseneckApiError = exports.CLIENT_ERROR_CODES = void 0;
+exports.KasseneckValidationError = exports.KasseneckAuthError = exports.KasseneckNetworkError = exports.KasseneckHttpError = exports.KasseneckApiError = exports.CLIENT_ERROR_CODES = exports.PAYMENT_CALL_REJECTED_CODES = void 0;
 exports.causeDigest = causeDigest;
 exports.fehlerDetails = fehlerDetails;
 exports.isOutcomeUnknown = isOutcomeUnknown;
@@ -227,7 +227,77 @@ const AUSGANG_UNKLAR_CODES = new Set([
     'cancellation_outcome_unknown',
     'response_unreadable',
 ]);
-function ausgangAusCode(code, details) {
+/**
+ * Aufrufe, die Geld bewegen: `hobexPayApi` belastet eine Karte,
+ * `hobexRefundApi` erstattet, `stripeCaptureIntent` zieht eine vorgemerkte
+ * Zahlung ein. Ihre Handler antworten auch NACH dem Anbieteraufruf mit einer
+ * Fehlerhuelle ohne Code ("Error hobex details", "Fehler beim Capturing");
+ * dort gilt darum umgekehrt: Ausgang unklar, ausser der Code belegt, dass der
+ * Anbieter nie gerufen wurde.
+ */
+const GELDWEGE = new Set(['hobexPayApi', 'hobexRefundApi', 'stripeCaptureIntent']);
+/**
+ * Codes, die auf einem Geldweg `outcome: 'rejected'` ergeben; jeder andere
+ * Code und eine Huelle ohne Code sind dort `'unknown'`. Aufgenommen ist nur,
+ * was entsteht, bevor das Backend den Zahlungsanbieter anspricht (Vertrag
+ * v3, `errorCodes`; dieselbe Liste wie `paymentCallRejectedCodes` im
+ * Dart-Zwilling):
+ *
+ * - `errorCodes.auth` ohne die sieben des Partner-Zugangs (18 Codes):
+ *   Anmeldung und Pruefung in `checkRequest` laufen vor jeder Zeile des
+ *   Handlers; `validation` heisst dort Pflichtfeld fehlt oder falscher Typ.
+ *   Der Partner-Zugang trifft diese `api_key`-Aufrufe mit Kassen-Token nie.
+ * - aus `errorCodes.edge`: `not_found` (unbekannter Endpunkt, HTTP 404) und
+ *   `internal_translation_error` (die Anfrage liess sich nicht uebersetzen,
+ *   es wurde nichts ausgefuehrt); `validation` des Rands (unbekannte Felder,
+ *   Rumpf ohne Objekt) steht schon oben.
+ * - `module_inactive` und `not_permitted`: das Modul- bzw. Rechte-Tor steht
+ *   ebenfalls vor dem Anbieter.
+ * - `route_missing` (vergibt das Paket): HTML ohne `/v3`-Kennzeichen, keine
+ *   Function hat den Aufruf gesehen.
+ *
+ * Nicht darin: `dialect_mismatch` (das Paket vergibt ihn auch, wenn ein Rand
+ * ohne `/v3` geantwortet hat, dessen Handler gelaufen sein kann) und
+ * `response_translation_failed` (der Handler lief; auch `handled: false`
+ * heisst nur, dass seine Antwort ein Fehler war, und der kann hinter dem
+ * Anbieteraufruf entstanden sein). Der Sammelfang der Handler ("Error hobex
+ * details", "Fehler beim Capturing") antwortet ohne Code.
+ */
+exports.PAYMENT_CALL_REJECTED_CODES = Object.freeze([
+    // errorCodes.auth ohne Partner-Zugang
+    'method_not_allowed',
+    'validation',
+    'cashregister_token_missing',
+    'cashregister_token_invalid',
+    'cashregister_not_found',
+    'account_not_found',
+    'live_not_enabled',
+    'unauthorized',
+    'mfa_required',
+    'user_verification_failed',
+    'admin_required',
+    'register_user_not_allowed',
+    'register_user_no_business',
+    'register_user_not_found',
+    'user_disabled',
+    'session_expired',
+    'cashregister_not_assigned',
+    'session_other_cashregister',
+    // errorCodes.edge vor dem Handler (validation steht oben)
+    'not_found',
+    'internal_translation_error',
+    // Modul- und Rechte-Tor
+    'module_inactive',
+    'not_permitted',
+    // vom Paket vergeben
+    'route_missing',
+]);
+const GELDWEG_ABGELEHNT = new Set(exports.PAYMENT_CALL_REJECTED_CODES);
+function ausgangAusCode(functionName, code, details) {
+    // `functionName` kann den Vorgang tragen (`financeWebService/<method>`).
+    if (GELDWEGE.has(functionName.split('/')[0])) {
+        return code !== undefined && GELDWEG_ABGELEHNT.has(code) ? 'rejected' : 'unknown';
+    }
     if (code === undefined)
         return 'rejected';
     if (AUSGANG_UNKLAR_CODES.has(code))
@@ -271,7 +341,10 @@ class KasseneckApiError extends Error {
      * `cancellation_outcome_unknown`, `response_unreadable` (Erfolg gemeldet,
      * Antwort eines Aufrufs mit Wirkung aber unlesbar) und
      * `response_translation_failed` (ausser mit `details.handled === false`);
-     * sonst `'rejected'`. Bei `'unknown'` nie wiederholen, sondern nachlesen.
+     * sonst `'rejected'`. Auf den Geldwegen (`hobexPayApi`, `hobexRefundApi`,
+     * `stripeCaptureIntent`) umgekehrt: `'rejected'` nur mit einem Code aus
+     * [PAYMENT_CALL_REJECTED_CODES], ohne Code und mit jedem anderen Code
+     * `'unknown'`. Bei `'unknown'` nie wiederholen, sondern nachlesen.
      */
     outcome;
     constructor(functionName, serverMessage, details = {}, code) {
@@ -283,7 +356,7 @@ class KasseneckApiError extends Error {
         // den Details. So bleibt die Klasse fuer beide Ablageorte dieselbe.
         const kandidat = code !== undefined ? code : details['code'];
         this.code = typeof kandidat === 'string' && BEZEICHNER.test(kandidat) ? kandidat : undefined;
-        this.outcome = ausgangAusCode(this.code, details);
+        this.outcome = ausgangAusCode(functionName, this.code, details);
     }
 }
 exports.KasseneckApiError = KasseneckApiError;

package/dist/cjs/payments/hobex.d.ts

@@ -47,8 +47,9 @@ export interface HobexTransactionIdOptions {
  * nicht.
  *
  * **Nie wiederholen.** Bei `isOutcomeUnknown(e)` (Netz, Zeitlimit, HTTP 5xx,
- * unlesbare Antwort) kann die Karte belastet sein: den Stand ueber die
- * Transaktionskennung nachlesen, nicht ein zweites Mal belasten.
+ * unlesbare Antwort, Fehlerhuelle ohne Code oder mit einem Code ausserhalb
+ * der Ablehnungscodes, README `outcome`) kann die Karte belastet sein: den Stand
+ * ueber die Transaktionskennung nachlesen, nicht ein zweites Mal belasten.
  */
 export declare function hobexPay(transport: InternerTransport, options: HobexPayOptions): Promise<HobexReceipt>;
 /**
@@ -62,8 +63,10 @@ export declare function hobexPay(transport: InternerTransport, options: HobexPay
  * Wahrheitswert waere hier also immer `true` — eine Luege ueber den
  * Informationsgehalt, an der ein Aufrufer ein `if` aufhaengt, das nie greift.
  * Misserfolg kommt als geworfener Fehler: eine Fehlerhuelle als
- * [KasseneckApiError] mit Code, Netz, Zeitlimit, HTTP 5xx und eine unlesbare
- * Erfolgsantwort mit `outcome: 'unknown'` (die Erstattung kann gelaufen sein).
+ * [KasseneckApiError], `'rejected'` nur mit einem der Ablehnungscodes
+ * (README `outcome`); ohne Code oder mit anderem Code, bei Netz,
+ * Zeitlimit, HTTP 5xx und unlesbarer Erfolgsantwort `outcome: 'unknown'`
+ * (die Erstattung kann gelaufen sein).
  * Ein `false` an dieser Stelle luede zum zweiten Versuch ein, also zur
  * doppelten Erstattung. **Nie wiederholen**, sondern den Stand nachlesen.
  *

package/dist/cjs/payments/hobex.js

@@ -43,8 +43,9 @@ const ENDPUNKT_REFUND = 'hobexRefundApi';
  * nicht.
  *
  * **Nie wiederholen.** Bei `isOutcomeUnknown(e)` (Netz, Zeitlimit, HTTP 5xx,
- * unlesbare Antwort) kann die Karte belastet sein: den Stand ueber die
- * Transaktionskennung nachlesen, nicht ein zweites Mal belasten.
+ * unlesbare Antwort, Fehlerhuelle ohne Code oder mit einem Code ausserhalb
+ * der Ablehnungscodes, README `outcome`) kann die Karte belastet sein: den Stand
+ * ueber die Transaktionskennung nachlesen, nicht ein zweites Mal belasten.
  */
 async function hobexPay(transport, options) {
     const params = zahlungsNutzlast(ENDPUNKT_PAY, options);
@@ -69,8 +70,10 @@ async function hobexPay(transport, options) {
  * Wahrheitswert waere hier also immer `true` — eine Luege ueber den
  * Informationsgehalt, an der ein Aufrufer ein `if` aufhaengt, das nie greift.
  * Misserfolg kommt als geworfener Fehler: eine Fehlerhuelle als
- * [KasseneckApiError] mit Code, Netz, Zeitlimit, HTTP 5xx und eine unlesbare
- * Erfolgsantwort mit `outcome: 'unknown'` (die Erstattung kann gelaufen sein).
+ * [KasseneckApiError], `'rejected'` nur mit einem der Ablehnungscodes
+ * (README `outcome`); ohne Code oder mit anderem Code, bei Netz,
+ * Zeitlimit, HTTP 5xx und unlesbarer Erfolgsantwort `outcome: 'unknown'`
+ * (die Erstattung kann gelaufen sein).
  * Ein `false` an dieser Stelle luede zum zweiten Versuch ein, also zur
  * doppelten Erstattung. **Nie wiederholen**, sondern den Stand nachlesen.
  *

package/dist/cjs/payments/stripe.d.ts

@@ -59,6 +59,8 @@ export declare function createStripeLink(transport: InternerTransport, options:
  * Pflichtparameter.
  *
  * **Nie wiederholen.** Bei `isOutcomeUnknown(e)` (Netz, Zeitlimit, HTTP 5xx,
- * unlesbare Antwort) kann der Einzug gelaufen sein: den Stand nachlesen.
+ * unlesbare Antwort, Fehlerhuelle ohne Code oder mit einem Code ausserhalb
+ * der Ablehnungscodes, README `outcome`) kann der Einzug gelaufen sein: den Stand
+ * nachlesen.
  */
 export declare function stripeCaptureIntent(transport: InternerTransport, stripeSessionId: string): Promise<StripeCaptureResult>;

package/dist/cjs/payments/stripe.js

@@ -74,7 +74,9 @@ async function createStripeLink(transport, options) {
  * Pflichtparameter.
  *
  * **Nie wiederholen.** Bei `isOutcomeUnknown(e)` (Netz, Zeitlimit, HTTP 5xx,
- * unlesbare Antwort) kann der Einzug gelaufen sein: den Stand nachlesen.
+ * unlesbare Antwort, Fehlerhuelle ohne Code oder mit einem Code ausserhalb
+ * der Ablehnungscodes, README `outcome`) kann der Einzug gelaufen sein: den Stand
+ * nachlesen.
  */
 async function stripeCaptureIntent(transport, stripeSessionId) {
     if (typeof stripeSessionId !== 'string' || !stripeSessionId.trim()) {

package/dist/cjs/version.d.ts

@@ -4,4 +4,4 @@
  * Client-Version, Nachtrag §6). Ein Test haelt sie gleich mit `package.json`;
  * beim Anheben der Version beide Stellen aendern.
  */
-export declare const PACKAGE_VERSION = "1.0.0-rc.3";
+export declare const PACKAGE_VERSION = "1.0.0-rc.4";

package/dist/cjs/version.js

@@ -7,4 +7,4 @@ exports.PACKAGE_VERSION = void 0;
  * Client-Version, Nachtrag §6). Ein Test haelt sie gleich mit `package.json`;
  * beim Anheben der Version beide Stellen aendern.
  */
-exports.PACKAGE_VERSION = '1.0.0-rc.3';
+exports.PACKAGE_VERSION = '1.0.0-rc.4';

package/dist/esm/client/errors.d.ts

@@ -110,6 +110,34 @@ export declare function fehlerDetails(daten: unknown, geheimnisse: readonly stri
  * das Ergebnis nachlesen.
  */
 export type ErrorOutcome = 'unknown' | 'rejected';
+/**
+ * Codes, die auf einem Geldweg `outcome: 'rejected'` ergeben; jeder andere
+ * Code und eine Huelle ohne Code sind dort `'unknown'`. Aufgenommen ist nur,
+ * was entsteht, bevor das Backend den Zahlungsanbieter anspricht (Vertrag
+ * v3, `errorCodes`; dieselbe Liste wie `paymentCallRejectedCodes` im
+ * Dart-Zwilling):
+ *
+ * - `errorCodes.auth` ohne die sieben des Partner-Zugangs (18 Codes):
+ *   Anmeldung und Pruefung in `checkRequest` laufen vor jeder Zeile des
+ *   Handlers; `validation` heisst dort Pflichtfeld fehlt oder falscher Typ.
+ *   Der Partner-Zugang trifft diese `api_key`-Aufrufe mit Kassen-Token nie.
+ * - aus `errorCodes.edge`: `not_found` (unbekannter Endpunkt, HTTP 404) und
+ *   `internal_translation_error` (die Anfrage liess sich nicht uebersetzen,
+ *   es wurde nichts ausgefuehrt); `validation` des Rands (unbekannte Felder,
+ *   Rumpf ohne Objekt) steht schon oben.
+ * - `module_inactive` und `not_permitted`: das Modul- bzw. Rechte-Tor steht
+ *   ebenfalls vor dem Anbieter.
+ * - `route_missing` (vergibt das Paket): HTML ohne `/v3`-Kennzeichen, keine
+ *   Function hat den Aufruf gesehen.
+ *
+ * Nicht darin: `dialect_mismatch` (das Paket vergibt ihn auch, wenn ein Rand
+ * ohne `/v3` geantwortet hat, dessen Handler gelaufen sein kann) und
+ * `response_translation_failed` (der Handler lief; auch `handled: false`
+ * heisst nur, dass seine Antwort ein Fehler war, und der kann hinter dem
+ * Anbieteraufruf entstanden sein). Der Sammelfang der Handler ("Error hobex
+ * details", "Fehler beim Capturing") antwortet ohne Code.
+ */
+export declare const PAYMENT_CALL_REJECTED_CODES: readonly string[];
 /**
  * Codes, die das Paket selbst vergibt, nicht der Server: `route_missing`
  * (HTML statt Backend, der Aufruf kam nie an) und `response_unreadable`
@@ -146,7 +174,10 @@ export declare class KasseneckApiError extends Error {
      * `cancellation_outcome_unknown`, `response_unreadable` (Erfolg gemeldet,
      * Antwort eines Aufrufs mit Wirkung aber unlesbar) und
      * `response_translation_failed` (ausser mit `details.handled === false`);
-     * sonst `'rejected'`. Bei `'unknown'` nie wiederholen, sondern nachlesen.
+     * sonst `'rejected'`. Auf den Geldwegen (`hobexPayApi`, `hobexRefundApi`,
+     * `stripeCaptureIntent`) umgekehrt: `'rejected'` nur mit einem Code aus
+     * [PAYMENT_CALL_REJECTED_CODES], ohne Code und mit jedem anderen Code
+     * `'unknown'`. Bei `'unknown'` nie wiederholen, sondern nachlesen.
      */
     readonly outcome: ErrorOutcome;
     constructor(functionName: string, serverMessage: string, details?: Record<string, unknown>, code?: string);

package/dist/esm/client/errors.js

@@ -215,7 +215,77 @@ const AUSGANG_UNKLAR_CODES = new Set([
     'cancellation_outcome_unknown',
     'response_unreadable',
 ]);
-function ausgangAusCode(code, details) {
+/**
+ * Aufrufe, die Geld bewegen: `hobexPayApi` belastet eine Karte,
+ * `hobexRefundApi` erstattet, `stripeCaptureIntent` zieht eine vorgemerkte
+ * Zahlung ein. Ihre Handler antworten auch NACH dem Anbieteraufruf mit einer
+ * Fehlerhuelle ohne Code ("Error hobex details", "Fehler beim Capturing");
+ * dort gilt darum umgekehrt: Ausgang unklar, ausser der Code belegt, dass der
+ * Anbieter nie gerufen wurde.
+ */
+const GELDWEGE = new Set(['hobexPayApi', 'hobexRefundApi', 'stripeCaptureIntent']);
+/**
+ * Codes, die auf einem Geldweg `outcome: 'rejected'` ergeben; jeder andere
+ * Code und eine Huelle ohne Code sind dort `'unknown'`. Aufgenommen ist nur,
+ * was entsteht, bevor das Backend den Zahlungsanbieter anspricht (Vertrag
+ * v3, `errorCodes`; dieselbe Liste wie `paymentCallRejectedCodes` im
+ * Dart-Zwilling):
+ *
+ * - `errorCodes.auth` ohne die sieben des Partner-Zugangs (18 Codes):
+ *   Anmeldung und Pruefung in `checkRequest` laufen vor jeder Zeile des
+ *   Handlers; `validation` heisst dort Pflichtfeld fehlt oder falscher Typ.
+ *   Der Partner-Zugang trifft diese `api_key`-Aufrufe mit Kassen-Token nie.
+ * - aus `errorCodes.edge`: `not_found` (unbekannter Endpunkt, HTTP 404) und
+ *   `internal_translation_error` (die Anfrage liess sich nicht uebersetzen,
+ *   es wurde nichts ausgefuehrt); `validation` des Rands (unbekannte Felder,
+ *   Rumpf ohne Objekt) steht schon oben.
+ * - `module_inactive` und `not_permitted`: das Modul- bzw. Rechte-Tor steht
+ *   ebenfalls vor dem Anbieter.
+ * - `route_missing` (vergibt das Paket): HTML ohne `/v3`-Kennzeichen, keine
+ *   Function hat den Aufruf gesehen.
+ *
+ * Nicht darin: `dialect_mismatch` (das Paket vergibt ihn auch, wenn ein Rand
+ * ohne `/v3` geantwortet hat, dessen Handler gelaufen sein kann) und
+ * `response_translation_failed` (der Handler lief; auch `handled: false`
+ * heisst nur, dass seine Antwort ein Fehler war, und der kann hinter dem
+ * Anbieteraufruf entstanden sein). Der Sammelfang der Handler ("Error hobex
+ * details", "Fehler beim Capturing") antwortet ohne Code.
+ */
+export const PAYMENT_CALL_REJECTED_CODES = Object.freeze([
+    // errorCodes.auth ohne Partner-Zugang
+    'method_not_allowed',
+    'validation',
+    'cashregister_token_missing',
+    'cashregister_token_invalid',
+    'cashregister_not_found',
+    'account_not_found',
+    'live_not_enabled',
+    'unauthorized',
+    'mfa_required',
+    'user_verification_failed',
+    'admin_required',
+    'register_user_not_allowed',
+    'register_user_no_business',
+    'register_user_not_found',
+    'user_disabled',
+    'session_expired',
+    'cashregister_not_assigned',
+    'session_other_cashregister',
+    // errorCodes.edge vor dem Handler (validation steht oben)
+    'not_found',
+    'internal_translation_error',
+    // Modul- und Rechte-Tor
+    'module_inactive',
+    'not_permitted',
+    // vom Paket vergeben
+    'route_missing',
+]);
+const GELDWEG_ABGELEHNT = new Set(PAYMENT_CALL_REJECTED_CODES);
+function ausgangAusCode(functionName, code, details) {
+    // `functionName` kann den Vorgang tragen (`financeWebService/<method>`).
+    if (GELDWEGE.has(functionName.split('/')[0])) {
+        return code !== undefined && GELDWEG_ABGELEHNT.has(code) ? 'rejected' : 'unknown';
+    }
     if (code === undefined)
         return 'rejected';
     if (AUSGANG_UNKLAR_CODES.has(code))
@@ -259,7 +329,10 @@ export class KasseneckApiError extends Error {
      * `cancellation_outcome_unknown`, `response_unreadable` (Erfolg gemeldet,
      * Antwort eines Aufrufs mit Wirkung aber unlesbar) und
      * `response_translation_failed` (ausser mit `details.handled === false`);
-     * sonst `'rejected'`. Bei `'unknown'` nie wiederholen, sondern nachlesen.
+     * sonst `'rejected'`. Auf den Geldwegen (`hobexPayApi`, `hobexRefundApi`,
+     * `stripeCaptureIntent`) umgekehrt: `'rejected'` nur mit einem Code aus
+     * [PAYMENT_CALL_REJECTED_CODES], ohne Code und mit jedem anderen Code
+     * `'unknown'`. Bei `'unknown'` nie wiederholen, sondern nachlesen.
      */
     outcome;
     constructor(functionName, serverMessage, details = {}, code) {
@@ -271,7 +344,7 @@ export class KasseneckApiError extends Error {
         // den Details. So bleibt die Klasse fuer beide Ablageorte dieselbe.
         const kandidat = code !== undefined ? code : details['code'];
         this.code = typeof kandidat === 'string' && BEZEICHNER.test(kandidat) ? kandidat : undefined;
-        this.outcome = ausgangAusCode(this.code, details);
+        this.outcome = ausgangAusCode(functionName, this.code, details);
     }
 }
 const GRUND_TEXT = {

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

@@ -47,8 +47,9 @@ export interface HobexTransactionIdOptions {
  * nicht.
  *
  * **Nie wiederholen.** Bei `isOutcomeUnknown(e)` (Netz, Zeitlimit, HTTP 5xx,
- * unlesbare Antwort) kann die Karte belastet sein: den Stand ueber die
- * Transaktionskennung nachlesen, nicht ein zweites Mal belasten.
+ * unlesbare Antwort, Fehlerhuelle ohne Code oder mit einem Code ausserhalb
+ * der Ablehnungscodes, README `outcome`) kann die Karte belastet sein: den Stand
+ * ueber die Transaktionskennung nachlesen, nicht ein zweites Mal belasten.
  */
 export declare function hobexPay(transport: InternerTransport, options: HobexPayOptions): Promise<HobexReceipt>;
 /**
@@ -62,8 +63,10 @@ export declare function hobexPay(transport: InternerTransport, options: HobexPay
  * Wahrheitswert waere hier also immer `true` — eine Luege ueber den
  * Informationsgehalt, an der ein Aufrufer ein `if` aufhaengt, das nie greift.
  * Misserfolg kommt als geworfener Fehler: eine Fehlerhuelle als
- * [KasseneckApiError] mit Code, Netz, Zeitlimit, HTTP 5xx und eine unlesbare
- * Erfolgsantwort mit `outcome: 'unknown'` (die Erstattung kann gelaufen sein).
+ * [KasseneckApiError], `'rejected'` nur mit einem der Ablehnungscodes
+ * (README `outcome`); ohne Code oder mit anderem Code, bei Netz,
+ * Zeitlimit, HTTP 5xx und unlesbarer Erfolgsantwort `outcome: 'unknown'`
+ * (die Erstattung kann gelaufen sein).
  * Ein `false` an dieser Stelle luede zum zweiten Versuch ein, also zur
  * doppelten Erstattung. **Nie wiederholen**, sondern den Stand nachlesen.
  *

package/dist/esm/payments/hobex.js

@@ -38,8 +38,9 @@ const ENDPUNKT_REFUND = 'hobexRefundApi';
  * nicht.
  *
  * **Nie wiederholen.** Bei `isOutcomeUnknown(e)` (Netz, Zeitlimit, HTTP 5xx,
- * unlesbare Antwort) kann die Karte belastet sein: den Stand ueber die
- * Transaktionskennung nachlesen, nicht ein zweites Mal belasten.
+ * unlesbare Antwort, Fehlerhuelle ohne Code oder mit einem Code ausserhalb
+ * der Ablehnungscodes, README `outcome`) kann die Karte belastet sein: den Stand
+ * ueber die Transaktionskennung nachlesen, nicht ein zweites Mal belasten.
  */
 export async function hobexPay(transport, options) {
     const params = zahlungsNutzlast(ENDPUNKT_PAY, options);
@@ -64,8 +65,10 @@ export async function hobexPay(transport, options) {
  * Wahrheitswert waere hier also immer `true` — eine Luege ueber den
  * Informationsgehalt, an der ein Aufrufer ein `if` aufhaengt, das nie greift.
  * Misserfolg kommt als geworfener Fehler: eine Fehlerhuelle als
- * [KasseneckApiError] mit Code, Netz, Zeitlimit, HTTP 5xx und eine unlesbare
- * Erfolgsantwort mit `outcome: 'unknown'` (die Erstattung kann gelaufen sein).
+ * [KasseneckApiError], `'rejected'` nur mit einem der Ablehnungscodes
+ * (README `outcome`); ohne Code oder mit anderem Code, bei Netz,
+ * Zeitlimit, HTTP 5xx und unlesbarer Erfolgsantwort `outcome: 'unknown'`
+ * (die Erstattung kann gelaufen sein).
  * Ein `false` an dieser Stelle luede zum zweiten Versuch ein, also zur
  * doppelten Erstattung. **Nie wiederholen**, sondern den Stand nachlesen.
  *

package/dist/esm/payments/stripe.d.ts

@@ -59,6 +59,8 @@ export declare function createStripeLink(transport: InternerTransport, options:
  * Pflichtparameter.
  *
  * **Nie wiederholen.** Bei `isOutcomeUnknown(e)` (Netz, Zeitlimit, HTTP 5xx,
- * unlesbare Antwort) kann der Einzug gelaufen sein: den Stand nachlesen.
+ * unlesbare Antwort, Fehlerhuelle ohne Code oder mit einem Code ausserhalb
+ * der Ablehnungscodes, README `outcome`) kann der Einzug gelaufen sein: den Stand
+ * nachlesen.
  */
 export declare function stripeCaptureIntent(transport: InternerTransport, stripeSessionId: string): Promise<StripeCaptureResult>;

package/dist/esm/payments/stripe.js

@@ -70,7 +70,9 @@ export async function createStripeLink(transport, options) {
  * Pflichtparameter.
  *
  * **Nie wiederholen.** Bei `isOutcomeUnknown(e)` (Netz, Zeitlimit, HTTP 5xx,
- * unlesbare Antwort) kann der Einzug gelaufen sein: den Stand nachlesen.
+ * unlesbare Antwort, Fehlerhuelle ohne Code oder mit einem Code ausserhalb
+ * der Ablehnungscodes, README `outcome`) kann der Einzug gelaufen sein: den Stand
+ * nachlesen.
  */
 export async function stripeCaptureIntent(transport, stripeSessionId) {
     if (typeof stripeSessionId !== 'string' || !stripeSessionId.trim()) {

package/dist/esm/version.d.ts

@@ -4,4 +4,4 @@
  * Client-Version, Nachtrag §6). Ein Test haelt sie gleich mit `package.json`;
  * beim Anheben der Version beide Stellen aendern.
  */
-export declare const PACKAGE_VERSION = "1.0.0-rc.3";
+export declare const PACKAGE_VERSION = "1.0.0-rc.4";

package/dist/esm/version.js

@@ -4,4 +4,4 @@
  * Client-Version, Nachtrag §6). Ein Test haelt sie gleich mit `package.json`;
  * beim Anheben der Version beide Stellen aendern.
  */
-export const PACKAGE_VERSION = '1.0.0-rc.3';
+export const PACKAGE_VERSION = '1.0.0-rc.4';

package/fixtures/hobex-hps-codes.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.0-rc.3",
+  "version": "1.0.0-rc.4",
   "measuredOn": {
     "tid": "3600335",
     "hpsVersion": "1.10.0",

package/fixtures/invoice-api.schema.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "Kasseneck Rechnungs-API",
   "version": 2,
-  "package": "1.0.0-rc.3",
+  "package": "1.0.0-rc.4",
   "endpoints": {
     "createCustomer": {
       "request": {

package/fixtures/invoice-texts.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.0-rc.3",
+  "version": "1.0.0-rc.4",
   "languages": [
     "de",
     "en"

package/fixtures/pos-texts.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.0-rc.3",
+  "version": "1.0.0-rc.4",
   "messages": {
     "network.no_connection": {
       "text": "Keine Verbindung zum Server. Bitte die Internetverbindung prüfen und erneut versuchen."

package/fixtures/surface.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.0-rc.3",
+  "version": "1.0.0-rc.4",
   "baseUrls": {
     "public": "https://api.kasseneck.at/v3",
     "pos": "https://kasse.kasseneck.at/api/v3"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kreiseck/kasseneck-api",
-  "version": "1.0.0-rc.3",
+  "version": "1.0.0-rc.4",
   "description": "Austrian fiscal cash register (RKSV) client for JavaScript and TypeScript: signed receipts, cancellations, card payments, receipt printing (ESC/POS), invoices. RKSV-Registrierkasse für JavaScript und TypeScript.",
   "license": "Apache-2.0",
   "author": "Kreiseck",