@kreiseck/kasseneck-api 1.5.0 → 1.5.1

package/dist/cjs/client/errors.js

@@ -26,20 +26,27 @@
  *   **Entscheidend ist `outcome`:** `'rejected'` heisst abgelehnt, nichts
  *   geschehen, Wiederholen hilft nicht. `'unknown'` heisst: der Vorgang kann
  *   ausgefuehrt sein (bei `createReceipt` ein signierter Beleg). Dann **nie
- *   wiederholen**, sondern das Ergebnis nachlesen (Belegliste, `getReceipt`).
+ *   blind wiederholen**: Belege, Stornos und Zahlungen nachlesen
+ *   (Belegliste, `getReceipt`, Terminal-Beleg); ein Aufruf mit
+ *   `idempotencyKey` (Lager schreiben, Rechnung, Partner-Betrieb mit
+ *   Schluessel) darf mit **demselben** Schluessel erneut gesendet werden und
+ *   wirkt genau einmal, nie mit einem neuen. `createInvoiceItem` erkennt die
+ *   Wiederholung an `source` + `reference` (dieselben Werte erneut senden);
+ *   Posten aendern oder zurueckziehen und Mandate haben keinen Schluessel:
+ *   erst nachlesen.
  * - `KasseneckHttpError` — die Antwort war **keine** verwertbare Huelle:
  *   HTTP 500/404 ohne Huelle, leerer Rumpf oder Text statt JSON. Beim
  *   Bericht-Download gelten dieselben Gruende fuer alles, was kein PDF ist.
  *   `reason` trennt die Faelle maschinenlesbar. Auf einem Aufruf mit
- *   Wirkung (signierend oder geldbewegend) hat HTTP 5xx
+ *   Wirkung (`UNKNOWN_OUTCOME_CALLS` in aufrufe.ts) hat HTTP 5xx
  *   `outcome: 'unknown'`, ebenso HTTP 200 mit Kennzeichen, aber leerem oder
  *   unlesbarem Rumpf.
  * - `KasseneckNetworkError` — die Antwort kam gar nicht: Netz weg, DNS,
  *   abgebrochene Verbindung oder Zeitueberschreitung (`timedOut`). Auch hier
  *   gilt `outcome`: war die Anfrage schon unterwegs und ist der Aufruf einer
- *   mit Wirkung (signierend: `createReceipt`, `cancelReceipt`,
- *   `financeWebService`; geldbewegend: `hobexPayApi`, `hobexRefundApi`,
- *   `stripeCaptureIntent`), ist er `'unknown'`.
+ *   mit Wirkung (signieren, Geld bewegen, buchen, ausstellen, anlegen,
+ *   aendern, loeschen, senden; die Liste `UNKNOWN_OUTCOME_CALLS`), ist er
+ *   `'unknown'`. Lesen und Probelauf bleiben `'rejected'`.
  * - `KasseneckAuthError` — es kam nicht einmal zur Anfrage, weil die Anmeldung
  *   scheiterte (fehlende Zugangsdaten, oder der Token-/Sitzungsgeber warf).
  *   In der Browser-Kasse mit ihrer 90-Sekunden-Sitzung ist das Alltag, kein
@@ -378,12 +385,12 @@ class KasseneckHttpError extends Error {
     /** Maschinenlesbarer Grund — trennt den Rewrite-Fall vom 500er ohne Textparsen. */
     reason;
     /**
-     * `'unknown'` auf einem Aufruf mit Wirkung (`createReceipt`,
-     * `cancelReceipt`, `financeWebService`, `hobexPayApi`, `hobexRefundApi`,
-     * `stripeCaptureIntent`) bei HTTP 5xx und bei HTTP 200 mit
-     * Kennzeichen, aber unlesbarem Rumpf (`empty-body`, `not-json` auch bei
-     * `text/html`, `missing-status`): der Handler kann gelaufen sein, nie wiederholen,
-     * sondern nachlesen. Sonst `'rejected'` (auch 4xx).
+     * `'unknown'` auf einem Aufruf mit Wirkung (`UNKNOWN_OUTCOME_CALLS`:
+     * signieren, Geld bewegen, buchen, ausstellen, anlegen, aendern, loeschen,
+     * senden) bei HTTP 5xx und bei HTTP 200 mit Kennzeichen, aber unlesbarem
+     * Rumpf (`empty-body`, `not-json` auch bei `text/html`, `missing-status`):
+     * der Handler kann gelaufen sein, nie blind wiederholen (siehe
+     * [ErrorOutcome]). Sonst `'rejected'` (auch 4xx, Lesen und Probelauf).
      */
     outcome;
     constructor(functionName, statusCode, contentType, reason, outcome = 'rejected') {
@@ -410,9 +417,10 @@ class KasseneckNetworkError extends Error {
     /** Code der zugrunde liegenden Ursache, sofern unbedenklich (z. B. `ECONNREFUSED`). */
     causeCode;
     /**
-     * `'unknown'`, wenn die Anfrage schon unterwegs war und der Aufruf signiert
-     * (`createReceipt`, `cancelReceipt`, `financeWebService`): dann nie
-     * wiederholen, sondern nachlesen. Sonst `'rejected'`.
+     * `'unknown'`, wenn die Anfrage schon unterwegs war und der Aufruf Wirkung
+     * hat (`UNKNOWN_OUTCOME_CALLS`): dann nie blind wiederholen (siehe
+     * [ErrorOutcome]). Sonst `'rejected'`, auch bei Lesen und Probelauf und
+     * wenn schon die Anmeldung das Zeitlimit verbrauchte.
      */
     outcome;
     constructor(functionName, timedOut, timeoutMs, cause = {}, outcome = 'rejected') {
@@ -481,9 +489,12 @@ class KasseneckValidationError extends Error {
 exports.KasseneckValidationError = KasseneckValidationError;
 /**
  * Ist der Ausgang dieses Fehlers unklar (`outcome === 'unknown'`)? Dann den
- * Aufruf **nicht wiederholen**, sondern das Ergebnis nachlesen. Gilt fuer
- * jede Fehlerart; nur [KasseneckApiError], [KasseneckHttpError] und
- * [KasseneckNetworkError] koennen `'unknown'` sein.
+ * Aufruf **nicht blind wiederholen**: Belege, Stornos und Zahlungen
+ * nachlesen; einen Aufruf mit `idempotencyKey` nur mit **demselben**
+ * Schluessel erneut senden (wirkt genau einmal, ein neuer buchte doppelt);
+ * ohne Schluessel erst nachlesen. Gilt fuer jede Fehlerart; nur
+ * [KasseneckApiError], [KasseneckHttpError] und [KasseneckNetworkError]
+ * koennen `'unknown'` sein.
  */
 function isOutcomeUnknown(error) {
     return ((error instanceof KasseneckApiError || error instanceof KasseneckHttpError || error instanceof KasseneckNetworkError)

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

@@ -1,6 +1,6 @@
 export { type AuthCredentials, type KasseneckAuth, type ApiKeyAuthOptions, type RegisterUserAuthOptions, apiKeyAuth, registerUserAuth, } from './auth.js';
-export { DEFAULT_BASE_URL, POS_BASE_URL, DEFAULT_TIMEOUT_MS, type HttpResponseLike, type HttpRequestInit, type FetchLike, type TransportOptions, type TransportBodyFields, type KasseneckTransport, type KasseneckBinaryTransport, createTransport, createBinaryTransport, } from './transport.js';
-export { ALL_CALLS, type ApiCall, PUBLIC_CALLS, POS_CALLS, type PublicCall, type PosCall, } from './aufrufe.js';
+export { DEFAULT_BASE_URL, POS_BASE_URL, DEFAULT_TIMEOUT_MS, type HttpResponseLike, type HttpRequestInit, type FetchLike, type TransportOptions, type TransportBodyFields, type TransportCallOptions, type KasseneckTransport, type KasseneckBinaryTransport, createTransport, createBinaryTransport, } from './transport.js';
+export { ALL_CALLS, type ApiCall, PUBLIC_CALLS, POS_CALLS, UNKNOWN_OUTCOME_CALLS, type PublicCall, type PosCall, } from './aufrufe.js';
 export { KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, type ValidationScope, type KasseneckError, type HttpFailureReason, type CauseDigest, type ErrorOutcome, CLIENT_ERROR_CODES, type ClientErrorCode, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, isOutcomeUnknown, } from './errors.js';
 export { type ReceiptCommonOptions, type SellReceiptOptions, type TipOptions, type TipRecipientShare, type CancelReceiptOptions, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, paymentsExpectedCents, cardRefundReference, receiptLayoutFromResult, cancelReceipt, type CancelReceiptResult, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, type ListMyReceiptsOptions, type ReceiptList, type ReceiptListStats, checkVoucherCombinationError, type SendReceiptEmailOptions, type SendReceiptEmailResult, sendReceiptEmail, } from './receipts.js';
 export { listMyCashregisters } from './cashregisters.js';

package/dist/cjs/client/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createKasseneckApi = exports.getSignatureStatus = exports.getCashboxStatus = exports.getReportV2 = exports.downloadMonthlyReport = exports.downloadDailyReport = exports.listMyCashregisters = exports.sendReceiptEmail = exports.checkVoucherCombinationError = exports.listMyReceipts = exports.getFirstReceiptDate = exports.generateFullReceiptId = exports.getReceiptWithCompany = exports.getReceipt = exports.zeroReceipt = exports.cancelReceipt = exports.receiptLayoutFromResult = exports.cardRefundReference = exports.paymentsExpectedCents = exports.sellReceiptWithCompany = exports.sellReceipt = exports.isOutcomeUnknown = exports.isKasseneckValidationError = exports.isKasseneckNetworkError = exports.isKasseneckHttpError = exports.isKasseneckAuthError = exports.isKasseneckApiError = exports.CLIENT_ERROR_CODES = exports.KasseneckValidationError = exports.KasseneckNetworkError = exports.KasseneckHttpError = exports.KasseneckAuthError = exports.KasseneckApiError = exports.POS_CALLS = exports.PUBLIC_CALLS = exports.ALL_CALLS = exports.createBinaryTransport = exports.createTransport = exports.DEFAULT_TIMEOUT_MS = exports.POS_BASE_URL = exports.DEFAULT_BASE_URL = exports.registerUserAuth = exports.apiKeyAuth = void 0;
+exports.createKasseneckApi = exports.getSignatureStatus = exports.getCashboxStatus = exports.getReportV2 = exports.downloadMonthlyReport = exports.downloadDailyReport = exports.listMyCashregisters = exports.sendReceiptEmail = exports.checkVoucherCombinationError = exports.listMyReceipts = exports.getFirstReceiptDate = exports.generateFullReceiptId = exports.getReceiptWithCompany = exports.getReceipt = exports.zeroReceipt = exports.cancelReceipt = exports.receiptLayoutFromResult = exports.cardRefundReference = exports.paymentsExpectedCents = exports.sellReceiptWithCompany = exports.sellReceipt = exports.isOutcomeUnknown = exports.isKasseneckValidationError = exports.isKasseneckNetworkError = exports.isKasseneckHttpError = exports.isKasseneckAuthError = exports.isKasseneckApiError = exports.CLIENT_ERROR_CODES = exports.KasseneckValidationError = exports.KasseneckNetworkError = exports.KasseneckHttpError = exports.KasseneckAuthError = exports.KasseneckApiError = exports.UNKNOWN_OUTCOME_CALLS = exports.POS_CALLS = exports.PUBLIC_CALLS = exports.ALL_CALLS = exports.createBinaryTransport = exports.createTransport = exports.DEFAULT_TIMEOUT_MS = exports.POS_BASE_URL = exports.DEFAULT_BASE_URL = exports.registerUserAuth = exports.apiKeyAuth = void 0;
 var auth_js_1 = require("./auth.js");
 Object.defineProperty(exports, "apiKeyAuth", { enumerable: true, get: function () { return auth_js_1.apiKeyAuth; } });
 Object.defineProperty(exports, "registerUserAuth", { enumerable: true, get: function () { return auth_js_1.registerUserAuth; } });
@@ -14,6 +14,7 @@ var aufrufe_js_1 = require("./aufrufe.js");
 Object.defineProperty(exports, "ALL_CALLS", { enumerable: true, get: function () { return aufrufe_js_1.ALL_CALLS; } });
 Object.defineProperty(exports, "PUBLIC_CALLS", { enumerable: true, get: function () { return aufrufe_js_1.PUBLIC_CALLS; } });
 Object.defineProperty(exports, "POS_CALLS", { enumerable: true, get: function () { return aufrufe_js_1.POS_CALLS; } });
+Object.defineProperty(exports, "UNKNOWN_OUTCOME_CALLS", { enumerable: true, get: function () { return aufrufe_js_1.UNKNOWN_OUTCOME_CALLS; } });
 var errors_js_1 = require("./errors.js");
 Object.defineProperty(exports, "KasseneckApiError", { enumerable: true, get: function () { return errors_js_1.KasseneckApiError; } });
 Object.defineProperty(exports, "KasseneckAuthError", { enumerable: true, get: function () { return errors_js_1.KasseneckAuthError; } });

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

@@ -33,6 +33,12 @@ import { type KasseneckAuth } from './auth.js';
  * **Kein Wiederholen fehlgeschlagener Aufrufe.** Ein Beleg ist nicht folgenlos
  * wiederholbar; ohne entschiedene Idempotenz waere ein automatischer zweiter
  * Versuch ein zweiter Beleg.
+ *
+ * **Ausgang je Aufruf.** Ob ein Scheitern nach dem Senden `outcome: 'unknown'`
+ * traegt, haengt am Aufruf: mit Wirkung ([UNKNOWN_OUTCOME_CALLS] in
+ * aufrufe.ts) ja, Lesen und Probelauf nein. Ein Probelauf traegt denselben
+ * Namen wie der echte Aufruf; die Huelle sagt es darum beim Aufruf
+ * (`hasEffect: false`, [TransportCallOptions]).
  */
 /** Basis-URL der oeffentlichen API (Produktion). */
 export declare const DEFAULT_BASE_URL = "https://api.kasseneck.at/v3";
@@ -151,7 +157,27 @@ export interface TransportBodyFields {
     /** Vorgangsart von `financeWebService` (z. B. `status_cashbox`). */
     method?: string;
 }
-export type KasseneckTransport = <T = unknown>(functionName: string, params?: Record<string, unknown>, extraBodyFields?: TransportBodyFields, secretParams?: readonly string[]) => Promise<T>;
+/**
+ * Einstellungen fuer **einen** Aufruf, die nicht mitgesendet werden.
+ */
+export interface TransportCallOptions {
+    /**
+     * Hat dieser Aufruf Wirkung? Entscheidet den Ausgang, wenn er scheitert,
+     * nachdem die Anfrage unterwegs war (Netzfehler, Zeitlimit, HTTP 5xx,
+     * unlesbare Erfolgsantwort, HTML mit Kennzeichen): `true` ergibt
+     * `outcome: 'unknown'`. Ohne Angabe gilt die Liste des Pakets
+     * (`UNKNOWN_OUTCOME_CALLS`); ein Name, den sie nicht kennt, gilt dann als
+     * ohne Wirkung.
+     *
+     * `true` fuer einen Aufruf mit Wirkung, den dieses Paket nicht kennt.
+     * `false` gilt **nur zusammen mit `params.dryRun === true`** (Probelauf
+     * unter dem Namen des echten Aufrufs, schreibt nichts) und ergibt dann
+     * `'rejected'`; ohne `dryRun: true` bleibt ein Aufruf aus der Liste
+     * `'unknown'`, was immer hier steht.
+     */
+    hasEffect?: boolean;
+}
+export type KasseneckTransport = <T = unknown>(functionName: string, params?: Record<string, unknown>, extraBodyFields?: TransportBodyFields, secretParams?: readonly string[], options?: TransportCallOptions) => Promise<T>;
 /**
  * Ruft eine Backend-Funktion auf, die **Binaerdaten** liefert (die beiden
  * Bericht-PDFs), und gibt sie als `Uint8Array` zurueck.

package/dist/cjs/client/transport.js

@@ -41,6 +41,12 @@ const errors_js_1 = require("./errors.js");
  * **Kein Wiederholen fehlgeschlagener Aufrufe.** Ein Beleg ist nicht folgenlos
  * wiederholbar; ohne entschiedene Idempotenz waere ein automatischer zweiter
  * Versuch ein zweiter Beleg.
+ *
+ * **Ausgang je Aufruf.** Ob ein Scheitern nach dem Senden `outcome: 'unknown'`
+ * traegt, haengt am Aufruf: mit Wirkung ([UNKNOWN_OUTCOME_CALLS] in
+ * aufrufe.ts) ja, Lesen und Probelauf nein. Ein Probelauf traegt denselben
+ * Namen wie der echte Aufruf; die Huelle sagt es darum beim Aufruf
+ * (`hasEffect: false`, [TransportCallOptions]).
  */
 /** Basis-URL der oeffentlichen API (Produktion). */
 exports.DEFAULT_BASE_URL = 'https://api.kasseneck.at/v3';
@@ -61,23 +67,6 @@ const VERSION_WERT = 'v3';
 const KASSENECK_HOSTS = new Set(['api.kasseneck.at', 'kasse.kasseneck.at']);
 /** Die 1.x-Linie spricht nur `/v3`: jede Basis endet so (`/v3` oder `/api/v3`). */
 const V3_ENDE = /\/v3$/;
-/**
- * Aufrufe mit Wirkung, die nie blind wiederholt werden duerfen: sie signieren
- * (`createReceipt`, `cancelReceipt`), loesen bei FinanzOnline etwas aus
- * (`financeWebService`) oder bewegen Geld (`hobexPayApi` belastet eine Karte,
- * `hobexRefundApi` erstattet, `stripeCaptureIntent` zieht eine vorgemerkte
- * Zahlung ein). Scheitert einer, nachdem die Anfrage unterwegs war (Netz,
- * Zeitlimit, HTTP 5xx, unlesbare Erfolgsantwort, HTML mit Kennzeichen), ist
- * sein Ausgang offen.
- */
-const UNKNOWN_OUTCOME_CALLS = new Set([
-    'createReceipt',
-    'cancelReceipt',
-    'financeWebService',
-    'hobexPayApi',
-    'hobexRefundApi',
-    'stripeCaptureIntent',
-]);
 /**
  * Produkte, die das Backend in `Kasseneck-Client` zaehlt (Positivliste,
  * Nachtrag §6); alles andere zaehlte dort als `ungueltig`. Das Paket weist
@@ -94,7 +83,7 @@ const CLIENT_MAX = 64;
 exports.DEFAULT_TIMEOUT_MS = 30_000;
 function createTransport(options) {
     const kern = createCore(options);
-    return (functionName, params, extraBodyFields, secretParams) => kern(functionName, params, extraBodyFields, secretParams, alsText, jsonAuswerten);
+    return (functionName, params, extraBodyFields, secretParams, callOptions) => kern(functionName, params, extraBodyFields, secretParams, callOptions, alsText, jsonAuswerten);
 }
 /**
  * Zweiter Einstiegspunkt fuer die Bericht-Downloads. Er liest die Antwort als
@@ -106,7 +95,7 @@ function createTransport(options) {
  */
 function createBinaryTransport(options) {
     const kern = createCore(options);
-    return (functionName, params) => kern(functionName, params, undefined, undefined, alsBytes, pdfAuswerten);
+    return (functionName, params) => kern(functionName, params, undefined, undefined, undefined, alsBytes, pdfAuswerten);
 }
 /**
  * Gemeinsamer Kern beider Einstiegspunkte: Anmeldung, Zeitlimit, Anfrage und
@@ -130,12 +119,21 @@ function createCore(options) {
      * (Berichte, Zahlungen, FinanzOnline), geht an die oeffentliche Basis.
      */
     const basisFuer = (functionName) => (0, aufrufe_js_1.isPosOnlyCall)(functionName) || (kassenweg && (0, aufrufe_js_1.isPosCall)(functionName)) ? kassenBasis : oeffentlicheBasis;
-    return async function aufrufen(functionName, params = {}, extraBodyFields, secretParams, lesen, auswerten) {
+    return async function aufrufen(functionName, params = {}, extraBodyFields, secretParams, callOptions, lesen, auswerten) {
         // Die URL nennt die Backend-Funktion, die Fehler nennen den **Vorgang**:
         // `financeWebService` fuehrt ein Dutzend verschiedener Vorgaenge unter einem
         // Endpunkt, und ein Fehler, der nur "financeWebService" sagt, verschweigt
         // dem Aufrufer, welcher davon scheiterte.
         const fehlerName = extraBodyFields?.method ? `${functionName}/${extraBodyFields.method}` : functionName;
+        // Ausgang eines Scheiterns nach dem Senden: offen, wenn der Aufruf Wirkung
+        // hat. `hasEffect: true` hebt einen fremden Aufruf auf `unknown`.
+        // `hasEffect: false` senkt einen Aufruf mit Wirkung nur, wenn er wirklich
+        // ein Probelauf ist (`dryRun === true`, so streng prueft auch das
+        // Backend): sonst liefe ein echter Beleg oder eine Buchung nach einem
+        // Zeitlimit als `rejected`, und genau das fuehrt zur Doppelbuchung.
+        const probelauf = callOptions?.hasEffect === false && params['dryRun'] === true;
+        const wirkung = callOptions?.hasEffect === true || ((0, aufrufe_js_1.isUnknownOutcomeCall)(functionName) && !probelauf);
+        const nachDemSenden = wirkung ? 'unknown' : 'rejected';
         // Das Zeitlimit laeuft ab HIER — es deckt die Anmeldung mit ab. Haengt die
         // Token-Erneuerung auf flauem Netz, haette der Aufruf sonst weder Ergebnis
         // noch Fehler, und die Kasse stuende still.
@@ -175,8 +173,9 @@ function createCore(options) {
                 }
                 // Bis hierher kam keine verwertbare Antwort: Netz weg oder Zeitlimit.
                 // Die Anfrage war schon unterwegs: bei einem Aufruf mit Wirkung kann
-                // der Beleg bzw. die Zahlung entstanden sein (Ausgang unklar, nachlesen).
-                return new errors_js_1.KasseneckNetworkError(fehlerName, abbruch.signal.aborted, zeitlimitMs, (0, errors_js_1.causeDigest)(ursache, geheimnisse), UNKNOWN_OUTCOME_CALLS.has(functionName) ? 'unknown' : 'rejected');
+                // der Vorgang ausgefuehrt sein (Beleg, Zahlung, Buchung, Rechnung;
+                // Ausgang unklar).
+                return new errors_js_1.KasseneckNetworkError(fehlerName, abbruch.signal.aborted, zeitlimitMs, (0, errors_js_1.causeDigest)(ursache, geheimnisse), nachDemSenden);
             };
             const basis = basisFuer(functionName);
             const url = `${basis}/${encodeURIComponent(functionName)}`;
@@ -230,7 +229,7 @@ function createCore(options) {
                         throw fehler;
                 }
                 // 5xx auf einem Aufruf mit Wirkung: der Handler kann gelaufen sein.
-                const ausgang = antwort.status >= 500 && UNKNOWN_OUTCOME_CALLS.has(functionName) ? 'unknown' : 'rejected';
+                const ausgang = antwort.status >= 500 ? nachDemSenden : 'rejected';
                 throw new errors_js_1.KasseneckHttpError(fehlerName, antwort.status, inhaltstyp, 'server-error', ausgang);
             }
             // HTTP 200 mit HTML: die Auffangregel der Single-Page-App hat den Aufruf
@@ -238,9 +237,9 @@ function createCore(options) {
             if (inhaltstyp !== undefined && /^\s*text\/html\b/i.test(inhaltstyp)) {
                 // Mit Kennzeichen hat der `/v3`-Rand den Aufruf gesehen (etwa ein
                 // Proxy, der nur den Inhaltstyp umschreibt). Bei einem Aufruf mit
-                // Wirkung kann der Beleg bzw. die Zahlung dann entstanden sein: unlesbarer Rumpf,
+                // Wirkung kann der Vorgang dann ausgefuehrt sein: unlesbarer Rumpf,
                 // Ausgang unklar, statt `route_missing`.
-                if (UNKNOWN_OUTCOME_CALLS.has(functionName) && traegtKennzeichen(antwort)) {
+                if (nachDemSenden === 'unknown' && traegtKennzeichen(antwort)) {
                     throw new errors_js_1.KasseneckHttpError(fehlerName, antwort.status, inhaltstyp, 'not-json', 'unknown');
                 }
                 throw new errors_js_1.KasseneckApiError(fehlerName, 'Route fehlt: die Antwort ist eine HTML-Seite statt des Backends', {}, 'route_missing');
@@ -258,8 +257,7 @@ function createCore(options) {
             // Ab hier kam HTTP 200 mit Kennzeichen: der `/v3`-Rand hat den Aufruf
             // gesehen. Ist der Rumpf dann unlesbar (gekuerzt von einem Proxy,
             // abgebrochene Verbindung), kann ein Handler mit Wirkung gelaufen sein.
-            const unlesbar = UNKNOWN_OUTCOME_CALLS.has(functionName) ? 'unknown' : 'rejected';
-            return auswerten(koerper, fehlerName, antwort.status, inhaltstyp, geheimnisse, unlesbar);
+            return auswerten(koerper, fehlerName, antwort.status, inhaltstyp, geheimnisse, nachDemSenden);
         }
         finally {
             // Ohne Abraeumen haelt der Wecker den Node-Prozess bis zum Zeitlimit wach.

package/dist/cjs/index.d.ts

@@ -1,6 +1,6 @@
 export { ReceiptType, type ReceiptTypeKey, VatRate, type VatRateKey, KeckPaymentMethod, type KeckPaymentMethodKey, CreditCardProvider, type CreditCardProviderKey, VoucherType, type VoucherTypeKey, VoucherAction, type VoucherActionKey, StripeLinkMode, type StripeLinkModeKey, } from './enums/index.js';
 export { type ReceiptItem, type ReceiptItemPayload, type ReceiptItemPayloadRead, toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, type TipRecipient, isTipItem, type Voucher, type VoucherPayload, toVoucherPayload, fromVoucherPayload, voucherIsValid, type Receipt, type RegistrationInfo, type ReceiptPayload, type ReceiptPayloadRead, toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, type CancellationOf, type CancellationItem, type Cancellation, type CancellationReason, type CancellationErrorCode, type CancellationStatus, type ReturnDisposition, RETURN_DISPOSITIONS, CANCELLATION_REASONS, CANCELLATION_STATUSES, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isReturnDisposition, isCancellationErrorCode, cancellationErrorCode, isCancellationError, cancellationFieldErrors, type CancellationFieldError, type ReceiptPayment, type ReceiptPaymentPayload, type ReceiptPaymentInput, fromReceiptPaymentPayload, toReceiptPaymentPayload, type PaymentErrorCode, PAYMENT_ERROR_CODES, isPaymentErrorCode, paymentErrorCode, isPaymentError, paymentFieldErrors, type PaymentFieldError, type ReceiptEmailErrorCode, type ReceiptEmailVia, RECEIPT_EMAIL_ERROR_CODES, RECEIPT_EMAIL_SEND_ERROR_CODES, type ReceiptEmailSendErrorCode, RECEIPT_EMAIL_VIAS, isReceiptEmailErrorCode, receiptEmailErrorCode, isReceiptEmailError, receiptEmailFieldErrors, type ReceiptEmailFieldError, type ReceiptErrorCode, type ReceiptFieldError, RECEIPT_ERROR_CODES, isReceiptErrorCode, receiptErrorCode, isReceiptError, receiptFieldErrors, remainingQuantities, type ReceiptCompany, type ReceiptCompanyPayload, fromReceiptCompanyPayload, receiptCompanyTaxInfo, type Cashregister, type CashregisterOnboarding, type CashregisterPayload, type CashregisterOnboardingPayload, fromCashregisterPayload, type ReceiptSummary, type ReceiptSummaryPayload, fromReceiptSummaryPayload, type ZeroKind, ZERO_KINDS, isZeroKind, type ReportMonth, reportMonthFromDate, previousReportMonth, nextReportMonth, reportMonthKey, reportMonthReadable, type StripeUrlSession, type StripeUrlSessionPayload, toStripeUrlSessionPayload, fromStripeUrlSessionPayload, type HobexReceipt, type HobexReceiptPayload, toHobexReceiptPayload, fromHobexReceiptPayload, hobexReceiptToCardPaymentData, hobexReceiptNeedsSignature, } from './models/index.js';
-export { type AuthCredentials, type KasseneckAuth, type ApiKeyAuthOptions, type RegisterUserAuthOptions, apiKeyAuth, registerUserAuth, DEFAULT_BASE_URL, POS_BASE_URL, DEFAULT_TIMEOUT_MS, type HttpResponseLike, type HttpRequestInit, type FetchLike, type TransportOptions, type TransportBodyFields, type KasseneckTransport, type KasseneckBinaryTransport, ALL_CALLS, type ApiCall, PUBLIC_CALLS, POS_CALLS, type PublicCall, type PosCall, createTransport, createBinaryTransport, KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, type ValidationScope, type KasseneckError, type HttpFailureReason, type CauseDigest, type ErrorOutcome, CLIENT_ERROR_CODES, type ClientErrorCode, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, isOutcomeUnknown, type ReceiptCommonOptions, type SellReceiptOptions, type TipOptions, type TipRecipientShare, type CancelReceiptOptions, type CancelReceiptResult, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, paymentsExpectedCents, cardRefundReference, receiptLayoutFromResult, cancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, type ListMyReceiptsOptions, type ReceiptList, type ReceiptListStats, listMyCashregisters, checkVoucherCombinationError, type SendReceiptEmailOptions, type SendReceiptEmailResult, sendReceiptEmail, downloadDailyReport, downloadMonthlyReport, getReportV2, type ReportV2, type ReportV2Metadata, type ReportV2Options, type CashboxStatus, type SignatureStatus, getCashboxStatus, getSignatureStatus, type KasseneckApi, createKasseneckApi, } from './client/index.js';
+export { type AuthCredentials, type KasseneckAuth, type ApiKeyAuthOptions, type RegisterUserAuthOptions, apiKeyAuth, registerUserAuth, DEFAULT_BASE_URL, POS_BASE_URL, DEFAULT_TIMEOUT_MS, type HttpResponseLike, type HttpRequestInit, type FetchLike, type TransportOptions, type TransportBodyFields, type TransportCallOptions, type KasseneckTransport, type KasseneckBinaryTransport, ALL_CALLS, type ApiCall, PUBLIC_CALLS, POS_CALLS, UNKNOWN_OUTCOME_CALLS, type PublicCall, type PosCall, createTransport, createBinaryTransport, KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, type ValidationScope, type KasseneckError, type HttpFailureReason, type CauseDigest, type ErrorOutcome, CLIENT_ERROR_CODES, type ClientErrorCode, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, isOutcomeUnknown, type ReceiptCommonOptions, type SellReceiptOptions, type TipOptions, type TipRecipientShare, type CancelReceiptOptions, type CancelReceiptResult, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, paymentsExpectedCents, cardRefundReference, receiptLayoutFromResult, cancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, type ListMyReceiptsOptions, type ReceiptList, type ReceiptListStats, listMyCashregisters, checkVoucherCombinationError, type SendReceiptEmailOptions, type SendReceiptEmailResult, sendReceiptEmail, downloadDailyReport, downloadMonthlyReport, getReportV2, type ReportV2, type ReportV2Metadata, type ReportV2Options, type CashboxStatus, type SignatureStatus, getCashboxStatus, getSignatureStatus, type KasseneckApi, createKasseneckApi, } from './client/index.js';
 export { type ReceiptDueTip, type ReceiptDueTipRecipient, type ReceiptDueOptions, type ReceiptDueBuckets, type ReceiptDueBreakdown, type ReceiptDueErrorReason, receiptDueCents, receiptDueBreakdown, ReceiptDueError, RECEIPT_DUE_ERROR_REASONS, isReceiptDueError, } from './receipt/due.js';
 export { parseServerTimeStamp, toViennaWallClock, type ViennaWallClock } from './vienna-time.js';
 export { type PosBusinessSettings, type PosDeviceSettings, type PosSettings, type ArticleGroup, type PosArticle, POS_BUSINESS_DEFAULTS, POS_DEVICE_DEFAULTS, mergePosSettings, fromArticleGroupPayload, fromPosArticlePayload, listMyArticleGroups, listMyArticles, getPosSettings, setMyPosSettings, setMyRegisterDeviceSettings, distributeDiscount, cancelScopeOf, receiptsScopeOf, stockViewOf, } from './pos/index.js';

package/dist/cjs/index.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.receiptFieldErrors = exports.isReceiptError = exports.receiptErrorCode = exports.isReceiptErrorCode = exports.RECEIPT_ERROR_CODES = exports.receiptEmailFieldErrors = exports.isReceiptEmailError = exports.receiptEmailErrorCode = exports.isReceiptEmailErrorCode = exports.RECEIPT_EMAIL_VIAS = exports.RECEIPT_EMAIL_SEND_ERROR_CODES = exports.RECEIPT_EMAIL_ERROR_CODES = exports.paymentFieldErrors = exports.isPaymentError = exports.paymentErrorCode = exports.isPaymentErrorCode = exports.PAYMENT_ERROR_CODES = exports.toReceiptPaymentPayload = exports.fromReceiptPaymentPayload = exports.cancellationFieldErrors = exports.isCancellationError = exports.cancellationErrorCode = exports.isCancellationErrorCode = exports.isReturnDisposition = exports.isCancellationReason = exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_ERROR_CODES = exports.CANCELLATION_STATUSES = exports.CANCELLATION_REASONS = exports.RETURN_DISPOSITIONS = exports.receiptSumCents = exports.receiptSubSumCents = exports.fromReceiptPayload = exports.toReceiptPayload = exports.voucherIsValid = exports.fromVoucherPayload = exports.toVoucherPayload = exports.isTipItem = exports.negateReceiptItem = exports.receiptItemIsValid = exports.receiptItemTotalCents = exports.fromReceiptItemPayload = exports.toReceiptItemPayload = exports.StripeLinkMode = exports.VoucherAction = exports.VoucherType = exports.CreditCardProvider = exports.KeckPaymentMethod = exports.VatRate = exports.ReceiptType = void 0;
-exports.generateFullReceiptId = exports.getReceiptWithCompany = exports.getReceipt = exports.zeroReceipt = exports.cancelReceipt = exports.receiptLayoutFromResult = exports.cardRefundReference = exports.paymentsExpectedCents = exports.sellReceiptWithCompany = exports.sellReceipt = exports.isOutcomeUnknown = exports.isKasseneckValidationError = exports.isKasseneckNetworkError = exports.isKasseneckHttpError = exports.isKasseneckAuthError = exports.isKasseneckApiError = exports.CLIENT_ERROR_CODES = exports.KasseneckValidationError = exports.KasseneckNetworkError = exports.KasseneckHttpError = exports.KasseneckAuthError = exports.KasseneckApiError = exports.createBinaryTransport = exports.createTransport = exports.POS_CALLS = exports.PUBLIC_CALLS = exports.ALL_CALLS = exports.DEFAULT_TIMEOUT_MS = exports.POS_BASE_URL = exports.DEFAULT_BASE_URL = exports.registerUserAuth = exports.apiKeyAuth = exports.hobexReceiptNeedsSignature = exports.hobexReceiptToCardPaymentData = exports.fromHobexReceiptPayload = exports.toHobexReceiptPayload = exports.fromStripeUrlSessionPayload = exports.toStripeUrlSessionPayload = exports.reportMonthReadable = exports.reportMonthKey = exports.nextReportMonth = exports.previousReportMonth = exports.reportMonthFromDate = exports.isZeroKind = exports.ZERO_KINDS = exports.fromReceiptSummaryPayload = exports.fromCashregisterPayload = exports.receiptCompanyTaxInfo = exports.fromReceiptCompanyPayload = exports.remainingQuantities = void 0;
-exports.stockViewOf = exports.receiptsScopeOf = exports.cancelScopeOf = exports.distributeDiscount = exports.setMyRegisterDeviceSettings = exports.setMyPosSettings = exports.getPosSettings = exports.listMyArticles = exports.listMyArticleGroups = exports.fromPosArticlePayload = exports.fromArticleGroupPayload = exports.mergePosSettings = exports.POS_DEVICE_DEFAULTS = exports.POS_BUSINESS_DEFAULTS = exports.toViennaWallClock = exports.parseServerTimeStamp = exports.isReceiptDueError = exports.RECEIPT_DUE_ERROR_REASONS = exports.ReceiptDueError = exports.receiptDueBreakdown = exports.receiptDueCents = exports.createKasseneckApi = exports.getSignatureStatus = exports.getCashboxStatus = exports.getReportV2 = exports.downloadMonthlyReport = exports.downloadDailyReport = exports.sendReceiptEmail = exports.checkVoucherCombinationError = exports.listMyCashregisters = exports.listMyReceipts = exports.getFirstReceiptDate = void 0;
+exports.getReceiptWithCompany = exports.getReceipt = exports.zeroReceipt = exports.cancelReceipt = exports.receiptLayoutFromResult = exports.cardRefundReference = exports.paymentsExpectedCents = exports.sellReceiptWithCompany = exports.sellReceipt = exports.isOutcomeUnknown = exports.isKasseneckValidationError = exports.isKasseneckNetworkError = exports.isKasseneckHttpError = exports.isKasseneckAuthError = exports.isKasseneckApiError = exports.CLIENT_ERROR_CODES = exports.KasseneckValidationError = exports.KasseneckNetworkError = exports.KasseneckHttpError = exports.KasseneckAuthError = exports.KasseneckApiError = exports.createBinaryTransport = exports.createTransport = exports.UNKNOWN_OUTCOME_CALLS = exports.POS_CALLS = exports.PUBLIC_CALLS = exports.ALL_CALLS = exports.DEFAULT_TIMEOUT_MS = exports.POS_BASE_URL = exports.DEFAULT_BASE_URL = exports.registerUserAuth = exports.apiKeyAuth = exports.hobexReceiptNeedsSignature = exports.hobexReceiptToCardPaymentData = exports.fromHobexReceiptPayload = exports.toHobexReceiptPayload = exports.fromStripeUrlSessionPayload = exports.toStripeUrlSessionPayload = exports.reportMonthReadable = exports.reportMonthKey = exports.nextReportMonth = exports.previousReportMonth = exports.reportMonthFromDate = exports.isZeroKind = exports.ZERO_KINDS = exports.fromReceiptSummaryPayload = exports.fromCashregisterPayload = exports.receiptCompanyTaxInfo = exports.fromReceiptCompanyPayload = exports.remainingQuantities = void 0;
+exports.stockViewOf = exports.receiptsScopeOf = exports.cancelScopeOf = exports.distributeDiscount = exports.setMyRegisterDeviceSettings = exports.setMyPosSettings = exports.getPosSettings = exports.listMyArticles = exports.listMyArticleGroups = exports.fromPosArticlePayload = exports.fromArticleGroupPayload = exports.mergePosSettings = exports.POS_DEVICE_DEFAULTS = exports.POS_BUSINESS_DEFAULTS = exports.toViennaWallClock = exports.parseServerTimeStamp = exports.isReceiptDueError = exports.RECEIPT_DUE_ERROR_REASONS = exports.ReceiptDueError = exports.receiptDueBreakdown = exports.receiptDueCents = exports.createKasseneckApi = exports.getSignatureStatus = exports.getCashboxStatus = exports.getReportV2 = exports.downloadMonthlyReport = exports.downloadDailyReport = exports.sendReceiptEmail = exports.checkVoucherCombinationError = exports.listMyCashregisters = exports.listMyReceipts = exports.getFirstReceiptDate = exports.generateFullReceiptId = void 0;
 var index_js_1 = require("./enums/index.js");
 Object.defineProperty(exports, "ReceiptType", { enumerable: true, get: function () { return index_js_1.ReceiptType; } });
 Object.defineProperty(exports, "VatRate", { enumerable: true, get: function () { return index_js_1.VatRate; } });
@@ -82,6 +82,7 @@ Object.defineProperty(exports, "DEFAULT_TIMEOUT_MS", { enumerable: true, get: fu
 Object.defineProperty(exports, "ALL_CALLS", { enumerable: true, get: function () { return index_js_3.ALL_CALLS; } });
 Object.defineProperty(exports, "PUBLIC_CALLS", { enumerable: true, get: function () { return index_js_3.PUBLIC_CALLS; } });
 Object.defineProperty(exports, "POS_CALLS", { enumerable: true, get: function () { return index_js_3.POS_CALLS; } });
+Object.defineProperty(exports, "UNKNOWN_OUTCOME_CALLS", { enumerable: true, get: function () { return index_js_3.UNKNOWN_OUTCOME_CALLS; } });
 Object.defineProperty(exports, "createTransport", { enumerable: true, get: function () { return index_js_3.createTransport; } });
 Object.defineProperty(exports, "createBinaryTransport", { enumerable: true, get: function () { return index_js_3.createBinaryTransport; } });
 Object.defineProperty(exports, "KasseneckApiError", { enumerable: true, get: function () { return index_js_3.KasseneckApiError; } });

package/dist/cjs/inventory/schreiben.d.ts

@@ -23,6 +23,9 @@
  * **Wiederholen:** nach einem Zeitlimit oder Netzfehler denselben Aufruf mit
  * **demselben** `idempotencyKey` noch einmal senden. Er wirkt genau einmal und
  * liefert die gespeicherte Antwort; ein neuer Schluessel buchte ein zweites Mal.
+ * Darum meldet jeder schreibende Aufruf in diesen Faellen (auch HTTP 5xx und
+ * unlesbare Antwort) `outcome: 'unknown'`, nie `'rejected'`. Lesen und der
+ * Probelauf (`previewGoodsReceipt`) bleiben `'rejected'`.
  */
 import type { InternerTransport } from '../client/aufrufe.js';
 import type { Article, ChangeStockConditionRequest, CreateArticleRequest, CreateReservationRequest, DeactivateArticleRequest, ExtendReservationRequest, GoodsReceiptPreview, GoodsReceiptPreviewRequest, ReceiveGoodsRequest, RecordStockLossRequest, ReleaseReservationRequest, Reservation, ReservationListQuery, ReservationPage, ReverseStockMovementRequest, StockOperation, TransferStockRequest, UpdateArticleRequest } from './typen.js';

package/dist/cjs/inventory/schreiben.js

@@ -24,6 +24,9 @@
  * **Wiederholen:** nach einem Zeitlimit oder Netzfehler denselben Aufruf mit
  * **demselben** `idempotencyKey` noch einmal senden. Er wirkt genau einmal und
  * liefert die gespeicherte Antwort; ein neuer Schluessel buchte ein zweites Mal.
+ * Darum meldet jeder schreibende Aufruf in diesen Faellen (auch HTTP 5xx und
+ * unlesbare Antwort) `outcome: 'unknown'`, nie `'rejected'`. Lesen und der
+ * Probelauf (`previewGoodsReceipt`) bleiben `'rejected'`.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createArticle = createArticle;
@@ -214,7 +217,9 @@ async function previewGoodsReceipt(transport, request) {
         delete p.idempotencyKey;
     schluessel(name, p, { pflicht: false });
     eingangZahlen(name, p);
-    const daten = await transport(name, { ...p, dryRun: true });
+    // Ein Probelauf schreibt nichts: nach einem Zeitlimit bleibt er `rejected`,
+    // obwohl `receiveGoods` sonst Wirkung hat.
+    const daten = await transport(name, { ...p, dryRun: true }, undefined, undefined, { hasEffect: false });
     return { preview: (0, lesen_js_1.liste)(name, daten, 'preview', lesen_js_1.vorschauZeile) };
 }
 const stueckPositionen = (name, p) => positionen(name, p.items, { pflicht: true, menge: 'pflicht' });

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

@@ -12,6 +12,12 @@
  * **Nicht automatisch wiederholen.** Wer nach einem Zeitlimit erneut
  * ausstellt, tut das mit **demselben** `idempotencyKey`: dann kommt die schon
  * ausgestellte Rechnung zurueck (`replayed: true`) statt einer zweiten.
+ * Jeder Aufruf mit Wirkung (ausstellen, stornieren, gutschreiben, Zahlung
+ * nachtragen, Kunde anlegen oder aendern) meldet nach Zeitlimit, Netzfehler,
+ * HTTP 5xx oder unlesbarer Antwort `outcome: 'unknown'`: er kann gewirkt
+ * haben. Mit Schluessel denselben Schluessel erneut senden, ohne Schluessel
+ * (`updateCustomer`, `createCustomer` ohne) erst nachlesen. Lesen und der
+ * Probelauf (`previewInvoice`) bleiben `'rejected'`.
  *
  * Nach dem Senden wird nichts hart gecastet: fehlt ein zugesagtes Feld, wirft
  * der Aufruf `KasseneckValidationError` mit `scope:'response'`.

package/dist/cjs/invoice/endpunkte.js

@@ -13,6 +13,12 @@
  * **Nicht automatisch wiederholen.** Wer nach einem Zeitlimit erneut
  * ausstellt, tut das mit **demselben** `idempotencyKey`: dann kommt die schon
  * ausgestellte Rechnung zurueck (`replayed: true`) statt einer zweiten.
+ * Jeder Aufruf mit Wirkung (ausstellen, stornieren, gutschreiben, Zahlung
+ * nachtragen, Kunde anlegen oder aendern) meldet nach Zeitlimit, Netzfehler,
+ * HTTP 5xx oder unlesbarer Antwort `outcome: 'unknown'`: er kann gewirkt
+ * haben. Mit Schluessel denselben Schluessel erneut senden, ohne Schluessel
+ * (`updateCustomer`, `createCustomer` ohne) erst nachlesen. Lesen und der
+ * Probelauf (`previewInvoice`) bleiben `'rejected'`.
  *
  * Nach dem Senden wird nichts hart gecastet: fehlt ein zugesagtes Feld, wirft
  * der Aufruf `KasseneckValidationError` mit `scope:'response'`.
@@ -110,7 +116,10 @@ async function searchCustomers(transport, search) {
 }
 // ---- Rechnungen -------------------------------------------------------------
 async function issueInvoice(transport, request) {
-    const daten = await transport('issueInvoice', nutzlast(request));
+    const params = nutzlast(request);
+    // Ohne Typen kann `dryRun: true` hier ankommen: dann ist es ein Probelauf
+    // ohne Wirkung (sonst: `previewInvoice`).
+    const daten = await transport('issueInvoice', params, undefined, undefined, { hasEffect: params['dryRun'] !== true });
     const ergebnis = {
         invoice: pflichtObjekt('issueInvoice', daten, 'invoice'),
         replayed: objekt(daten)['replayed'] === true,
@@ -131,7 +140,9 @@ async function issueInvoice(transport, request) {
  * Probelauf und Ausstellen kann sich der Kunde oder das Konto aendern.
  */
 async function previewInvoice(transport, request) {
-    const daten = await transport('issueInvoice', { ...nutzlast(request), dryRun: true });
+    // Ein Probelauf schreibt nichts: nach einem Zeitlimit bleibt er `rejected`,
+    // obwohl `issueInvoice` sonst Wirkung hat.
+    const daten = await transport('issueInvoice', { ...nutzlast(request), dryRun: true }, undefined, undefined, { hasEffect: false });
     const ergebnis = { preview: pflichtObjekt('issueInvoice', daten, 'preview') };
     const notice = hinweise(daten);
     if (notice)

package/dist/cjs/pos/texte.d.ts

@@ -661,12 +661,17 @@ export interface ErrorRuleDetail {
 export declare function findErrorRule(kind: ErrorKind, detail?: ErrorRuleDetail): ErrorRule;
 /**
  * Kassen-Aufrufe mit Wirkung, die sich nach einem Netzfehler nicht gefahrlos
- * wiederholen lassen: die sechs, deren Ausgang das Paket selbst als unklar
- * fuehrt (Beleg, auch Null- und Startbeleg ueber `createReceipt`, Storno,
- * FinanzOnline, die drei Geldwege), dazu der Druckjob (zweiter Bon) und die
- * Belegmail (zweite Mail). Ob die Anfrage vor dem Abriss schon draussen war,
- * sieht das Paket nicht (fetch wirft in beiden Faellen gleich); darum gilt
- * hier immer der vorsichtige Satz.
+ * wiederholen lassen: Beleg (auch Null- und Startbeleg ueber
+ * `createReceipt`), Storno, FinanzOnline, die drei Geldwege, der Druckjob
+ * (zweiter Bon) und die Belegmail (zweite Mail). Ob die Anfrage vor dem
+ * Abriss schon draussen war, sieht das Paket nicht (fetch wirft in beiden
+ * Faellen gleich); darum gilt hier immer der vorsichtige Satz, auch fuer
+ * einen Fehler, der vor dem Senden entstand.
+ *
+ * Seit 1.5.1 fuehrt der Transport jeden Aufruf mit Wirkung als unklar
+ * (`UNKNOWN_OUTCOME_CALLS`, eine Obermenge dieser Liste), und
+ * [messageOutcome] folgt zuerst ihm. Die Liste bleibt als Vertrag der
+ * Kassentexte (`callsWithEffect` in `fixtures/pos-texts.json`) unveraendert.
  */
 export declare const CALLS_WITH_EFFECT: readonly ["createReceipt", "cancelReceipt", "financeWebService", "hobexPayApi", "hobexRefundApi", "stripeCaptureIntent", "createPrintJob", "sendReceiptEmail"];
 /**

package/dist/cjs/pos/texte.js

@@ -378,12 +378,17 @@ function findErrorRule(kind, detail = {}) {
 }
 /**
  * Kassen-Aufrufe mit Wirkung, die sich nach einem Netzfehler nicht gefahrlos
- * wiederholen lassen: die sechs, deren Ausgang das Paket selbst als unklar
- * fuehrt (Beleg, auch Null- und Startbeleg ueber `createReceipt`, Storno,
- * FinanzOnline, die drei Geldwege), dazu der Druckjob (zweiter Bon) und die
- * Belegmail (zweite Mail). Ob die Anfrage vor dem Abriss schon draussen war,
- * sieht das Paket nicht (fetch wirft in beiden Faellen gleich); darum gilt
- * hier immer der vorsichtige Satz.
+ * wiederholen lassen: Beleg (auch Null- und Startbeleg ueber
+ * `createReceipt`), Storno, FinanzOnline, die drei Geldwege, der Druckjob
+ * (zweiter Bon) und die Belegmail (zweite Mail). Ob die Anfrage vor dem
+ * Abriss schon draussen war, sieht das Paket nicht (fetch wirft in beiden
+ * Faellen gleich); darum gilt hier immer der vorsichtige Satz, auch fuer
+ * einen Fehler, der vor dem Senden entstand.
+ *
+ * Seit 1.5.1 fuehrt der Transport jeden Aufruf mit Wirkung als unklar
+ * (`UNKNOWN_OUTCOME_CALLS`, eine Obermenge dieser Liste), und
+ * [messageOutcome] folgt zuerst ihm. Die Liste bleibt als Vertrag der
+ * Kassentexte (`callsWithEffect` in `fixtures/pos-texts.json`) unveraendert.
  */
 exports.CALLS_WITH_EFFECT = Object.freeze([
     'createReceipt',

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.5.0";
+export declare const PACKAGE_VERSION = "1.5.1";

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.5.0';
+exports.PACKAGE_VERSION = '1.5.1';

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

@@ -12,7 +12,7 @@
  * weiterhin jeden `string`: wer einen Aufruf braucht, den dieses Paket nicht
  * umhuellt, muss ihn weiterhin absetzen koennen.
  */
-import type { TransportBodyFields } from './transport.js';
+import type { TransportBodyFields, TransportCallOptions } from './transport.js';
 export declare const ALL_CALLS: readonly ["activateCashregister", "cancelInvoice", "cancelReceipt", "createCreditNote", "createCustomer", "createCustomerCashregister", "createPartnerCustomer", "checkPartnerCustomerEmail", "createPartnerWebhook", "createPaymentLinkStripe", "createPrintJob", "createReceipt", "deletePartnerWebhook", "downloadDailyReport", "downloadReport", "endRegisterSession", "financeWebService", "generateFullReceiptId", "getCustomer", "getCustomerCredentials", "getCustomerSignatureStatus", "getFirstReceiptDate", "getInvoice", "getInvoicePdf", "getInvoiceSetupStatus", "getInvoiceXml", "getKasseSettings", "getPartnerCustomer", "getPartnerInfo", "getPrintJob", "getReceipt", "getReportV2", "hobexPayApi", "hobexRefundApi", "issueInvoice", "listCustomerCashregisters", "listInvoices", "listBrands", "listMyArticleGroups", "listMyArticles", "listMyCashregisters", "listMyPrinters", "listMyReceipts", "listMyStock", "listMyStockLocations", "listMyTipRecipients", "listPartnerCustomers", "listPartnerWebhookDeliveries", "listPartnerWebhooks", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "pairRegisterDevice", "recordInvoicePayment", "registerPinLogin", "registerUserLogin", "renewRegisterSession", "reportCustomerContract", "requestCustomerSignature", "searchCustomers", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "setMyCashregisterStockLocation", "setMyKasseLogo", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "unpairRegisterDevice", "rotatePartnerWebhookSecret", "updateCustomer", "updatePartnerWebhook", "getArticle", "listArticles", "lookupArticleByCode", "listLocations", "getStock", "listStock", "listStockMovements", "createWebhook", "updateWebhook", "deleteWebhook", "listWebhooks", "sendWebhookTest", "rotateWebhookSecret", "listWebhookDeliveries", "createArticle", "updateArticle", "deactivateArticle", "receiveGoods", "transferStock", "recordStockLoss", "changeStockCondition", "reverseStockMovement", "createReservation", "extendReservation", "releaseReservation", "getReservation", "listReservations"];
 export type ApiCall = typeof ALL_CALLS[number];
 /**
@@ -31,6 +31,60 @@ export declare const PUBLIC_CALLS: readonly ["createReceipt", "getReceipt", "can
 export declare const POS_CALLS: readonly ["pairRegisterDevice", "listRegisterUsersForDevice", "listRegisterSessionsForDevice", "registerUserLogin", "registerPinLogin", "renewRegisterSession", "endRegisterSession", "unpairRegisterDevice", "listMyCashregisters", "listMyReceipts", "getReceipt", "createReceipt", "generateFullReceiptId", "cancelReceipt", "sendReceiptEmail", "listMyArticleGroups", "listMyArticles", "getKasseSettings", "setMyKasseSettings", "setMyKasseLogo", "setMyRegisterDeviceSettings", "listMyPrinters", "createPrintJob", "getPrintJob", "listMyTipRecipients", "listMyStockLocations", "listMyStock", "setMyCashregisterStockLocation"];
 export type PublicCall = typeof PUBLIC_CALLS[number];
 export type PosCall = typeof POS_CALLS[number];
+/**
+ * Die Aufrufe **mit Wirkung**, alphabetisch: sie legen etwas an, aendern oder
+ * loeschen es, buchen, signieren, bewegen Geld oder senden etwas hinaus
+ * (Mail, Druckjob, Probesendung). Scheitert einer, nachdem die Anfrage
+ * unterwegs war (Netzfehler, Zeitlimit, HTTP 5xx, unlesbare Erfolgsantwort,
+ * HTML mit Kennzeichen), meldet der Transport `outcome: 'unknown'`: der
+ * Vorgang kann ausgefuehrt sein.
+ *
+ * Bis 1.5.0 galt das nur fuer die sechs signierenden und geldbewegenden
+ * Aufrufe; ein Wareneingang oder eine Rechnung nach einem Zeitlimit kam als
+ * `'rejected'` an, und wer das glaubte und mit NEUEM Idempotenzschluessel
+ * neu sendete, buchte doppelt.
+ *
+ * Geht als `unknownOutcomeCalls` in den Vertrag (`fixtures/surface.json`);
+ * der Dart-Zwilling prueft seine Liste dagegen. Jeder Aufruf aus
+ * [ALL_CALLS], [PUBLIC_CALLS] und [POS_CALLS] steht entweder hier oder in
+ * [CALLS_WITHOUT_EFFECT] (Waechter `test/ausgang-einordnung.test.ts`).
+ */
+export declare const UNKNOWN_OUTCOME_CALLS: readonly ["activateCashregister", "cancelInvoice", "cancelReceipt", "changeStockCondition", "createArticle", "createCreditNote", "createCustomer", "createCustomerCashregister", "createInvoiceItem", "createPartnerCustomer", "createPartnerWebhook", "createPrintJob", "createReceipt", "createReservation", "createWebhook", "deactivateArticle", "deletePartnerWebhook", "deleteWebhook", "extendReservation", "financeWebService", "hobexPayApi", "hobexRefundApi", "issueInvoice", "pairRegisterDevice", "receiveGoods", "recordInvoicePayment", "recordStockLoss", "releaseReservation", "reportCustomerContract", "requestCustomerSignature", "reverseStockMovement", "revokeCustomerMandate", "rotatePartnerWebhookSecret", "rotateWebhookSecret", "sendPartnerCustomerFonLink", "sendPartnerWebhookTest", "sendReceiptEmail", "sendWebhookTest", "setCustomerMandate", "setMyCashregisterStockLocation", "setMyKasseLogo", "setMyKasseSettings", "setMyRegisterDeviceSettings", "stripeCaptureIntent", "transferStock", "unpairRegisterDevice", "updateArticle", "updateCustomer", "updateInvoiceItem", "updatePartnerWebhook", "updateWebhook", "withdrawInvoiceItem"];
+/** Warum ein Aufruf keine Wirkung hat, die ein Zeitlimit offen lassen koennte. */
+export type CallWithoutEffectReason = 'read' | 'repeatable';
+/**
+ * Die Aufrufe **ohne Wirkung**, je mit Grund. Bei ihnen bleibt es bei
+ * `outcome: 'rejected'`, auch nach Zeitlimit, Netzfehler oder HTTP 5xx; eine
+ * Wiederholung bucht nichts doppelt:
+ *
+ * - `read`: reines Lesen (auch Berichte, Dateien, `generateFullReceiptId`,
+ *   das nur einen Link-Schluessel ableitet, und `getCustomerCredentials`,
+ *   dessen Abruf das Backend nur mitschreibt).
+ * - `repeatable`: legt etwas an, das ohne die verlorene Antwort niemand
+ *   erreicht und das von selbst verfaellt, und bucht nichts. Die Sitzung der
+ *   Kassen-Anmeldung (anmelden, verlaengern, abmelden: eine Wiederholung legt
+ *   hoechstens eine weitere kurzlebige Sitzung an bzw. verlaengert oder
+ *   beendet dieselbe noch einmal) und der Stripe-Zahlungslink
+ *   (`createPaymentLinkStripe`: den Link kennt nur die Antwort, ein nie
+ *   zugestellter Link wird nie bezahlt; Geld bewegt erst die Zahlung bzw.
+ *   `stripeCaptureIntent`).
+ *
+ * Probelaeufe (`previewGoodsReceipt`, `previewInvoice`) teilen den Namen mit
+ * dem echten Aufruf und stehen darum nicht hier; die Huellen setzen fuer sie
+ * `hasEffect: false` beim Aufruf, das nur zusammen mit `dryRun: true` gilt
+ * (siehe `TransportCallOptions`).
+ *
+ * Paketintern; nicht Teil der Paketoberflaeche.
+ */
+export declare const CALLS_WITHOUT_EFFECT: Readonly<Record<string, CallWithoutEffectReason>>;
+/**
+ * Hat dieser Aufruf Wirkung, ist sein Ausgang nach Zeitlimit, Netzfehler,
+ * HTTP 5xx oder unlesbarer Erfolgsantwort also unklar? `financeWebService`
+ * zaehlt mit jedem Vorgang. Ein Name, den dieses Paket nicht kennt (der
+ * offene Transport nimmt jeden), ist `false`; wer so einen Aufruf mit Wirkung
+ * absetzt, sagt es mit `hasEffect: true`.
+ */
+export declare function isUnknownOutcomeCall(name: string): boolean;
 /** Einer der 28 Aufrufe des Kassenwegs. */
 export declare function isPosCall(name: string): boolean;
 /**
@@ -40,6 +94,6 @@ export declare function isPosCall(name: string): boolean;
  */
 export declare function isPosOnlyCall(name: string): boolean;
 /** Wie [KasseneckTransport], nur mit bekanntem Aufrufnamen. Nicht exportiert nach aussen. */
-export type InternerTransport = <T = unknown>(functionName: ApiCall, params?: Record<string, unknown>, extraBodyFields?: TransportBodyFields, secretParams?: readonly string[]) => Promise<T>;
+export type InternerTransport = <T = unknown>(functionName: ApiCall, params?: Record<string, unknown>, extraBodyFields?: TransportBodyFields, secretParams?: readonly string[], options?: TransportCallOptions) => Promise<T>;
 /** Wie [KasseneckBinaryTransport], nur mit bekanntem Aufrufnamen. */
 export type InternerBinaerTransport = (functionName: ApiCall, params?: Record<string, unknown>) => Promise<Uint8Array>;