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

package/CHANGELOG.md

@@ -19,6 +19,79 @@ bytes of every golden receipt.
 This entry is written in English, like the developer documentation from here
 on.
 
+### 1.0.0-rc.5
+
+Findings from moving the web register onto 1.0.
+
+- **Plain text for edge codes on the register screen.** `ERROR_RULES` is
+  unchanged (one rule per kind, as in rc.4), so a register that looks a rule
+  up by `kind` alone keeps showing the same sentence. New
+  `ERROR_CODE_RULES` refine it per code. `route_missing`, `not_found` and
+  `internal_translation_error` (nothing happened on the server) show
+  `server.connection_disturbed` ("Die Verbindung zum Kassenserver ist
+  gestört. Bitte kurz warten und erneut versuchen."). `dialect_mismatch`,
+  `response_translation_failed` and `response_unreadable` (outcome unknown)
+  show `server.response_unreadable` ("Die Antwort des Kassenservers war nicht
+  lesbar. Bitte die Kasse neu öffnen und vor einem neuen Versuch prüfen, ob
+  der letzte Vorgang schon gebucht ist."), which never invites a retry; a
+  test holds every code the package treats as outcome-unknown to that. Both
+  sentences fit both registers (no page, no browser). The technical
+  sentence of the package or the edge stays in `error.message`.
+  `findErrorRule(kind, { code, outcome })` applies the code rules, then the
+  outcome rules, then `ERROR_RULES`. `pos-texts.json` carries
+  `errorCodeRules`, `errorOutcomeRules` and `callsWithEffect` next to
+  `errorRules`. `pos-message-cases.json` is at version 2: a case may carry
+  `error.code` (`api`) or `error.outcome` (`timeout`, `network`); the cases
+  without them are byte for byte those of rc.4. Reason: until 0.31 an HTML
+  answer was an HTTP error and showed `server.unexpected`; under 1.0 it is an
+  API error, and the register showed "Route fehlt: …" to the cashier.
+- **Timeout and network error on a call with an effect never invite a
+  retry.** New `ERROR_OUTCOME_RULES`: with outcome `unknown`, `timeout` and
+  `network` show `network.outcome_unknown` ("Der Server hat nicht
+  geantwortet, der Vorgang kann trotzdem gebucht sein. Bitte vor einem neuen
+  Versuch prüfen, ob der letzte Vorgang schon gebucht ist."). New
+  `messageOutcome(error)` gives the outcome for the sentence: `unknown` when
+  `isOutcomeUnknown` says so, and after a timeout or network error on any
+  call in `CALLS_WITH_EFFECT` (the six with an unknown outcome, plus
+  `createPrintJob` and `sendReceiptEmail`); fetch fails the same way before
+  and after the request left, so the package cannot tell. Every other call
+  keeps the rc.4 sentence ("… und erneut versuchen."). Reason: after a
+  timeout the receipt, the card payment or the print job may already exist;
+  a retry could book or print it twice.
+- **New labels:** `register.device_unnamed` ("Kasse", a device without a
+  name, `deviceLabel: null`), `login.locked_seconds` (`{seconds}` left of the
+  PIN lock), `split.remaining_with_rounding` (`{amount}`, `{cents}` with its
+  sign: the last round of a split payment takes the rounding cent). Reason:
+  the web register had to write these words itself.
+- **`receiptDueCents` throws `ReceiptDueError`, not `RangeError`.** Code
+  `receipt_due_unavailable`, the cause in `reason` (`RECEIPT_DUE_ERROR_REASONS`,
+  e.g. `tip_without_goods` for a tip with an amount but no goods, also for a
+  staff tip), `outcome: 'rejected'`, guard `isReceiptDueError`. The cases are
+  in `fixtures/receipt-due-errors.json`. Every computed amount is unchanged
+  (the 1206 generated cases). Reason: a `RangeError` without a code could not
+  be told apart from a bug, and the register must say "not sent" before it
+  starts the card terminal.
+- **`./stored`: `fromStoredLayout`, `toStoredLayout`, `fromStoredPrintLogo`,
+  `toStoredPrintLogo`.** The internal form of the receipt layout (`regelwerk`,
+  banner `ton` `belegart`/`warnung`) and of the print logo (`stufe`,
+  `pxBreite`, `pxHoehe`, `breite`, `hoehe`, `zeilen`) to 1.0 and back, checked
+  against all 40 golden layouts as 0.31.0 wrote them, byte for byte including
+  the key order. `fromStoredLayout` returns `null` for anything short of a
+  whole layout (no or empty `lines`, a line that is not an object, no
+  `paperSize`), so the caller rebuilds it with the `TESTKASSE` banner.
+  Reason: the web register
+  cache, the panel and the lab each carried their own copy.
+- **`fromStoredReceipt` leaves English 1.0 values as they are** (a fixture
+  receipt with `cancellationReason: 'customer_cancelled'`). It did so
+  already; now it is promised and tested.
+- **`fixtures/v3` refreshed** from the backend (71af3bf). Only the input
+  fingerprints in `_quelle` change (the client-version check of 29.09);
+  no name, value or code.
+- **Contract versions:** a test holds the version in `surface.json`,
+  `pos-texts.json`, `invoice-texts.json`, `hobex-hps-codes.json` and
+  `invoice-api.schema.json` (and `PACKAGE_VERSION`, `package-lock.json`, this
+  file) to `package.json`.
+
 ### Migrating from 0.x
 
 #### The 0.x line

package/README.md

@@ -133,6 +133,12 @@ is turnover, spread over the VAT rates of the goods and discounted with them,
 while a staff tip goes untouched into the 0 % bucket. Only the register knows
 which one applies, so the helper never guesses.
 
+Input the amount cannot be computed from (a tip with an amount but no goods,
+a tip on a null receipt, a missing `tipRecipient` …) throws a
+`ReceiptDueError` with `code: 'receipt_due_unavailable'`, the cause in
+`reason` (`RECEIPT_DUE_ERROR_REASONS`) and `outcome: 'rejected'`: nothing has
+been sent. Tell the cashier before the card terminal is started.
+
 ## What a fiscal cash register in Austria must do
 
 The obligation to use a fiscal cash register and to issue receipts is set out
@@ -803,6 +809,21 @@ the register's text catalogue (`MESSAGES`, `LABELS`, `messageText`,
 `messageText('checkout.locked', { reason })`. The rendered German texts are
 the same as in 0.x.
 
+`ERROR_RULES` says which text a failed call shows, one rule per kind, the
+same in both registers. `ERROR_CODE_RULES` (per `error.code`) and
+`ERROR_OUTCOME_RULES` (per outcome) refine it; `findErrorRule(kind, { code,
+outcome: messageOutcome(error) })` applies all three in that order. A timeout
+or network error on a call with an effect (`CALLS_WITH_EFFECT`) shows
+`network.outcome_unknown`, which never suggests a retry. The edge codes
+show a plain German sentence instead of the package's technical sentence,
+which stays in `error.message` for the log: `route_missing`, `not_found` and
+`internal_translation_error` (nothing happened on the server)
+`server.connection_disturbed`, which suggests trying again;
+`dialect_mismatch`, `response_translation_failed` and `response_unreadable`
+(outcome unknown) `server.response_unreadable`, which asks to reopen the
+register and check whether the last operation was booked, and never
+suggests a retry.
+
 ## Stored documents (`./stored`)
 
 For clients that read Firestore directly, such as the admin panel. Stored
@@ -825,7 +846,20 @@ invalidStoredPosSettings({ betrieb, geraet });               // paths the server
 ```
 
 `fromStoredReceipt`, `fromStoredCompany` and `fromStoredArticle` complete the
-set. A broken document throws a `KasseneckValidationError`. There is no
+set. A broken document throws a `KasseneckValidationError`. `fromStoredReceipt`
+also takes a receipt that already carries the English 1.0 values (for example
+a fixture with `cancellationReason: 'customer_cancelled'`) and leaves them
+as they are; the package keeps it that way.
+
+The receipt layout and the print logo have an internal form as well: the
+backend under `/api` and the 0.x browser cache use `regelwerk` for `ruleset`,
+banner lines with `ton` (`belegart`, `warnung`) for `tone` (`receipt_type`,
+`warning`), and a print logo with `stufe`, `pxBreite`, `pxHoehe`, `breite`,
+`hoehe`, `zeilen`. `fromStoredLayout` reads either form and keeps the key
+order (`null` for anything short of a whole layout: no or empty `lines`, a
+line that is not an object, no `paperSize`; `receiptLayoutFromResult` then
+rebuilds it), `toStoredLayout` writes the internal one, and
+`fromStoredPrintLogo`/`toStoredPrintLogo` do the same for a `PrintLogo`. There is no
 reader for stored invoices: the server computes the invoice view, so read it
 with `getInvoice` and `listInvoices`.
 
@@ -1390,6 +1424,7 @@ in machine form what both sides agreed on, among them:
 | `invoice-api.schema.json` | JSON Schema of the invoice API | `npm run fixtures:rechnung` |
 | `pos-message-cases.json` | error cases and the message each one must show in both registers | by hand |
 | `receipt-due-generated.json` | 1206 amounts due computed by the backend's own code, the reference for `receiptDueCents` | `node scripts/v3-zahlbetrag-generieren.mjs` |
+| `receipt-due-errors.json` | input the amount due cannot be computed from, with the `reason` of the `ReceiptDueError` each one throws | by hand |
 | `v3/` | the backend's `/v3` contract (vocabulary, response cases, stored cases, amounts due), copied byte for byte | `node scripts/v3-vertrag-holen.mjs` |
 | `renames-1.0.json` | everything in these files that changed from 0.x to 1.0: paths (`files`), text catalogue keys (`texts`), placeholders, structural keys (`structure`), machine values (`values`), shape changes (`shapes`); rendered texts are unchanged | `npm run fixtures:umbenennung` |
 
@@ -1397,9 +1432,10 @@ They are generated and never edited by hand. CI regenerates the register
 settings and `surface.json` and fails if they differ from the committed
 files; the test suite checks the others against the code.
 
-`surface.json`, `hobex-hps-codes.json`, `pos-texts.json` and
-`invoice-texts.json` carry the package version. **After every `npm version`,
-regenerate them and commit them along**, otherwise the tests fail.
+`surface.json`, `hobex-hps-codes.json`, `pos-texts.json`,
+`invoice-texts.json` and `invoice-api.schema.json` carry the package version.
+**After every `npm version`, regenerate them and commit them along**,
+otherwise the tests fail (`test/versionen.test.ts`).
 
 ### And the other direction
 

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, CANCELLATION_REASONS, CANCELLATION_STATUSES, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, 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 ReceiptDueTip, type ReceiptDueTipRecipient, type ReceiptDueOptions, type ReceiptDueBuckets, type ReceiptDueBreakdown, receiptDueCents, receiptDueBreakdown, } from './receipt/due.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, } from './pos/index.js';

package/dist/cjs/index.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.fromReceiptCompanyPayload = exports.remainingQuantities = 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.isCancellationReason = exports.CANCELLATION_RESERVATION_MS = exports.CANCELLATION_ERROR_CODES = exports.CANCELLATION_STATUSES = exports.CANCELLATION_REASONS = 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.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.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 = void 0;
-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.receiptDueBreakdown = exports.receiptDueCents = exports.createKasseneckApi = exports.getSignatureStatus = exports.getCashboxStatus = exports.getReportV2 = exports.downloadMonthlyReport = exports.downloadDailyReport = exports.sendReceiptEmail = exports.checkVoucherCombinationError = exports.listMyCashregisters = void 0;
+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 = 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; } });
@@ -118,6 +118,9 @@ Object.defineProperty(exports, "createKasseneckApi", { enumerable: true, get: fu
 var due_js_1 = require("./receipt/due.js");
 Object.defineProperty(exports, "receiptDueCents", { enumerable: true, get: function () { return due_js_1.receiptDueCents; } });
 Object.defineProperty(exports, "receiptDueBreakdown", { enumerable: true, get: function () { return due_js_1.receiptDueBreakdown; } });
+Object.defineProperty(exports, "ReceiptDueError", { enumerable: true, get: function () { return due_js_1.ReceiptDueError; } });
+Object.defineProperty(exports, "RECEIPT_DUE_ERROR_REASONS", { enumerable: true, get: function () { return due_js_1.RECEIPT_DUE_ERROR_REASONS; } });
+Object.defineProperty(exports, "isReceiptDueError", { enumerable: true, get: function () { return due_js_1.isReceiptDueError; } });
 var vienna_time_js_1 = require("./vienna-time.js");
 Object.defineProperty(exports, "parseServerTimeStamp", { enumerable: true, get: function () { return vienna_time_js_1.parseServerTimeStamp; } });
 Object.defineProperty(exports, "toViennaWallClock", { enumerable: true, get: function () { return vienna_time_js_1.toViennaWallClock; } });

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

@@ -12,4 +12,4 @@ export { distributeDiscount } from '../receipt/discount.js';
 export { cancelScopeOf, receiptsScopeOf, type RegisterScope, type RegisterUserPerms } from '../register/pairing.js';
 export { type NetworkPrinter, type PrintJob, type PrintJobStatus, PRINT_JOB_STATUSES, type PrintJobSource, PRINT_JOB_SOURCES, isPrintJobFinished, type CreatePrintJobOptions, listMyPrinters, createPrintJob, getPrintJob, } from './drucker.js';
 export { listMyTipRecipients } from './trinkgeld.js';
-export { MESSAGES, ERROR_RULES, messageText, messageAppliesTo, RECEIPT_EMAIL_ERROR_MESSAGES, receiptEmailErrorMessage, CANCELLATION_PAYMENT_ERROR_MESSAGES, cancellationPaymentErrorMessage, LABELS, labelText, type TextEntry, type MessageKey, type ErrorKind, type Surface, type ReceiptEmailMessageCode, type CancellationPaymentMessageCode, type LabelKey, } from './texte.js';
+export { MESSAGES, ERROR_RULES, ERROR_CODE_RULES, ERROR_OUTCOME_RULES, CALLS_WITH_EFFECT, findErrorRule, messageOutcome, messageText, messageAppliesTo, RECEIPT_EMAIL_ERROR_MESSAGES, receiptEmailErrorMessage, CANCELLATION_PAYMENT_ERROR_MESSAGES, cancellationPaymentErrorMessage, LABELS, labelText, type TextEntry, type MessageKey, type ErrorKind, type ErrorRule, type ErrorRuleDetail, type Surface, type ReceiptEmailMessageCode, type CancellationPaymentMessageCode, type LabelKey, } from './texte.js';

package/dist/cjs/pos/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPosSettings = exports.allowedQuantity = exports.quantityDefaults = exports.quantityRuleForUnit = exports.QUANTITY_RULES = exports.listMyArticles = exports.listMyArticleGroups = exports.fromPosArticlePayload = exports.fromArticleGroupPayload = exports.DONE_SCREEN_SECONDS = exports.WATERMARK_SCALE = exports.LOGO_SCALE = exports.WATERMARK_STRENGTH = exports.WATERMARK_SIDE = exports.DISCOUNT = exports.AUTO_LOGOUT_MINUTES = exports.TILE_STYLE = exports.SETTINGS_FONT_SIZE = exports.LOGO_SIZE = exports.QR_MODE = exports.DRAWER_AUTO_OPEN = exports.CUT = exports.CODE_PAGE = exports.PAPER_SIZE = exports.TERMINAL_TYPE = exports.TERMINAL_VIA = exports.PRINTER_TYPE = exports.TILE_HEIGHT = exports.CATEGORY_POSITION = exports.LAYOUT = exports.RECEIPT_OUTPUT = exports.CARD_PROVIDER = exports.CHECKOUT_MODE = exports.TIP_MODE = exports.QUANTITY = exports.WATERMARK = exports.FONT_SIZE = exports.THEME = exports.posShortcutConflict = exports.POS_SHORTCUT_SHARED_PAIRS = exports.posSettingsChanges = exports.unknownPosSettingValues = exports.sanitizePosSettings = exports.mergePosSettings = exports.POS_DEVICE_VALUES = exports.POS_BUSINESS_VALUES = exports.POS_DEVICE_DEFAULTS = exports.POS_BUSINESS_DEFAULTS = exports.POS_SHORTCUT_DEFAULTS = exports.POS_SHORTCUT_ACTIONS = void 0;
-exports.labelText = exports.LABELS = exports.cancellationPaymentErrorMessage = exports.CANCELLATION_PAYMENT_ERROR_MESSAGES = exports.receiptEmailErrorMessage = exports.RECEIPT_EMAIL_ERROR_MESSAGES = exports.messageAppliesTo = exports.messageText = exports.ERROR_RULES = exports.MESSAGES = exports.listMyTipRecipients = exports.getPrintJob = exports.createPrintJob = exports.listMyPrinters = exports.isPrintJobFinished = exports.PRINT_JOB_SOURCES = exports.PRINT_JOB_STATUSES = exports.receiptsScopeOf = exports.cancelScopeOf = exports.distributeDiscount = exports.posFieldErrors = exports.isPosError = exports.posErrorCode = exports.isPosErrorCode = exports.POS_ERROR_CODES = exports.posSettingsFromWire = exports.setMyPosLogo = exports.setMyRegisterDeviceSettings = exports.setMyPosSettings = void 0;
+exports.labelText = exports.LABELS = exports.cancellationPaymentErrorMessage = exports.CANCELLATION_PAYMENT_ERROR_MESSAGES = exports.receiptEmailErrorMessage = exports.RECEIPT_EMAIL_ERROR_MESSAGES = exports.messageAppliesTo = exports.messageText = exports.messageOutcome = exports.findErrorRule = exports.CALLS_WITH_EFFECT = exports.ERROR_OUTCOME_RULES = exports.ERROR_CODE_RULES = exports.ERROR_RULES = exports.MESSAGES = exports.listMyTipRecipients = exports.getPrintJob = exports.createPrintJob = exports.listMyPrinters = exports.isPrintJobFinished = exports.PRINT_JOB_SOURCES = exports.PRINT_JOB_STATUSES = exports.receiptsScopeOf = exports.cancelScopeOf = exports.distributeDiscount = exports.posFieldErrors = exports.isPosError = exports.posErrorCode = exports.isPosErrorCode = exports.POS_ERROR_CODES = exports.posSettingsFromWire = exports.setMyPosLogo = exports.setMyRegisterDeviceSettings = exports.setMyPosSettings = void 0;
 /**
  * Kachel-Kasse: Einstellungen, Artikelgruppen/Artikel fuer Kacheln,
  * Rabattverteilung, Drucker, Trinkgeld-Empfaenger. Die Aufrufe heissen 1:1 wie
@@ -92,6 +92,11 @@ Object.defineProperty(exports, "listMyTipRecipients", { enumerable: true, get: f
 var texte_js_1 = require("./texte.js");
 Object.defineProperty(exports, "MESSAGES", { enumerable: true, get: function () { return texte_js_1.MESSAGES; } });
 Object.defineProperty(exports, "ERROR_RULES", { enumerable: true, get: function () { return texte_js_1.ERROR_RULES; } });
+Object.defineProperty(exports, "ERROR_CODE_RULES", { enumerable: true, get: function () { return texte_js_1.ERROR_CODE_RULES; } });
+Object.defineProperty(exports, "ERROR_OUTCOME_RULES", { enumerable: true, get: function () { return texte_js_1.ERROR_OUTCOME_RULES; } });
+Object.defineProperty(exports, "CALLS_WITH_EFFECT", { enumerable: true, get: function () { return texte_js_1.CALLS_WITH_EFFECT; } });
+Object.defineProperty(exports, "findErrorRule", { enumerable: true, get: function () { return texte_js_1.findErrorRule; } });
+Object.defineProperty(exports, "messageOutcome", { enumerable: true, get: function () { return texte_js_1.messageOutcome; } });
 Object.defineProperty(exports, "messageText", { enumerable: true, get: function () { return texte_js_1.messageText; } });
 Object.defineProperty(exports, "messageAppliesTo", { enumerable: true, get: function () { return texte_js_1.messageAppliesTo; } });
 Object.defineProperty(exports, "RECEIPT_EMAIL_ERROR_MESSAGES", { enumerable: true, get: function () { return texte_js_1.RECEIPT_EMAIL_ERROR_MESSAGES; } });

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

@@ -20,6 +20,7 @@
  * `only`), die Platzhalter und die Arten der Fehlerregeln (Abschnitte
  * `placeholders` und `structure`).
  */
+import { type ErrorOutcome } from '../client/errors.js';
 export type Surface = 'web' | 'app';
 export interface TextEntry {
     readonly text: string;
@@ -35,10 +36,19 @@ declare const MELDUNGEN_ROH: {
     readonly 'network.timeout': {
         readonly text: "Der Server antwortet nicht. Bitte die Internetverbindung prüfen und erneut versuchen.";
     };
+    readonly 'network.outcome_unknown': {
+        readonly text: "Der Server hat nicht geantwortet, der Vorgang kann trotzdem gebucht sein. Bitte vor einem neuen Versuch prüfen, ob der letzte Vorgang schon gebucht ist.";
+    };
     readonly 'server.unexpected': {
         readonly text: "Der Server hat unerwartet geantwortet (HTTP {status}). Bitte den Support verständigen.";
         readonly placeholders: readonly ["status"];
     };
+    readonly 'server.connection_disturbed': {
+        readonly text: "Die Verbindung zum Kassenserver ist gestört. Bitte kurz warten und erneut versuchen.";
+    };
+    readonly 'server.response_unreadable': {
+        readonly text: "Die Antwort des Kassenservers war nicht lesbar. Bitte die Kasse neu öffnen und vor einem neuen Versuch prüfen, ob der letzte Vorgang schon gebucht ist.";
+    };
     readonly 'pairing.code_missing': {
         readonly text: "Bitte den Kopplungs-Code eingeben.";
     };
@@ -543,8 +553,8 @@ export type MessageKey = keyof typeof MELDUNGEN_ROH;
 export declare const MESSAGES: Record<MessageKey, TextEntry>;
 /**
  * In welcher Reihenfolge ein Fehler eingeordnet wird, auf beiden Seiten
- * dieselbe. Jede Regel nennt ihre Art (`kind`) und entweder ein Verhalten
- * (`behavior`) oder den Schluessel des Satzes (`key`). Die Arten:
+ * dieselbe. Genau eine Regel je Art (`kind`), mit einem Verhalten
+ * (`behavior`) oder dem Schluessel des Satzes (`key`). Die Arten:
  *   api        - HTTP 200, `status:'error'`: der Satz des Backends, woertlich
  *                (`server_text`)
  *   plain_text - schon fuer den Bildschirm geschrieben: sein eigener Text
@@ -557,6 +567,11 @@ export declare const MESSAGES: Record<MessageKey, TextEntry>;
  *                (`fallback`)
  * Unter 0.x hiessen sie `klartext`, `zeitablauf`, `netz`, `unerwartet`,
  * `sonst` (Tabelle in `fixtures/renames-1.0.json`).
+ *
+ * Seit 1.0.0-rc.5 verfeinern [ERROR_CODE_RULES] und [ERROR_OUTCOME_RULES]
+ * diese Liste; sie stehen bewusst getrennt, damit ein Leser, der nur nach
+ * `kind` sucht, weiter genau den Satz von rc.4 zeigt. [findErrorRule] wendet
+ * alle drei in der richtigen Reihenfolge an.
  */
 export declare const ERROR_RULES: readonly [{
     readonly kind: "api";
@@ -578,6 +593,73 @@ export declare const ERROR_RULES: readonly [{
     readonly behavior: "fallback";
 }];
 export type ErrorKind = (typeof ERROR_RULES)[number]['kind'];
+/**
+ * Regeln je Code (`error.code`), vor der Regel der Art: sie ersetzen den
+ * technischen Satz des Pakets bzw. des Rands durch einen Menschentext. Der
+ * technische Satz bleibt in `error.message` fuers Protokoll.
+ *   - `dialect_mismatch`, `response_translation_failed`, `response_unreadable`:
+ *     Ausgang unklar, der Vorgang kann gebucht sein; der Satz raet nie zum
+ *     Wiederholen, sondern zum Nachsehen.
+ *   - `route_missing`, `not_found`, `internal_translation_error`: am Server
+ *     geschah nichts, ein neuer Versuch ist sicher (auch auf den Geldwegen:
+ *     alle drei stehen in `PAYMENT_CALL_REJECTED_CODES`).
+ */
+export declare const ERROR_CODE_RULES: readonly [{
+    readonly kind: "api";
+    readonly codes: readonly ["dialect_mismatch", "response_translation_failed", "response_unreadable"];
+    readonly key: "server.response_unreadable";
+}, {
+    readonly kind: "api";
+    readonly codes: readonly ["route_missing", "not_found", "internal_translation_error"];
+    readonly key: "server.connection_disturbed";
+}];
+/**
+ * Regeln je Ausgang, nach den Code-Regeln und vor der Regel der Art: eine
+ * Frist oder ein Netzfehler auf einem Aufruf mit Wirkung (Ausgang unklar,
+ * siehe [messageOutcome]) raet nie zum Wiederholen. Ein Netzfehler auf einem
+ * Aufruf ohne Wirkung behaelt den Satz von rc.4 („erneut versuchen“).
+ */
+export declare const ERROR_OUTCOME_RULES: readonly [{
+    readonly kind: "timeout";
+    readonly outcome: "unknown";
+    readonly key: "network.outcome_unknown";
+}, {
+    readonly kind: "network";
+    readonly outcome: "unknown";
+    readonly key: "network.outcome_unknown";
+}];
+export type ErrorRule = (typeof ERROR_RULES)[number] | (typeof ERROR_CODE_RULES)[number] | (typeof ERROR_OUTCOME_RULES)[number];
+/** Was ueber einen Fehler bekannt ist, ausser seiner Art. */
+export interface ErrorRuleDetail {
+    /** `error.code` eines `KasseneckApiError`. */
+    code?: string | null;
+    /** Ausgang fuer den Satz, siehe [messageOutcome]. */
+    outcome?: ErrorOutcome | null;
+}
+/**
+ * Die Regel fuer einen Fehler: zuerst eine Code-Regel mit passender Art und
+ * passendem `code`, dann eine Ausgangs-Regel mit passender Art und
+ * passendem `outcome`, sonst die Regel der Art aus [ERROR_RULES]. Beide
+ * Kassen ordnen so ein.
+ */
+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.
+ */
+export declare const CALLS_WITH_EFFECT: readonly ["createReceipt", "cancelReceipt", "financeWebService", "hobexPayApi", "hobexRefundApi", "stripeCaptureIntent", "createPrintJob", "sendReceiptEmail"];
+/**
+ * Der Ausgang, nach dem der Satz gewaehlt wird: `'unknown'`, wenn das Paket
+ * ihn als unklar fuehrt ([isOutcomeUnknown]) oder wenn eine Frist bzw. ein
+ * Netzfehler einen Aufruf aus [CALLS_WITH_EFFECT] traf; sonst der Ausgang
+ * des Fehlers (`'rejected'`) bzw. `undefined` fuer fremde Fehler.
+ */
+export declare function messageOutcome(error: unknown): ErrorOutcome | undefined;
 /**
  * Beleg per E-Mail senden: welcher `code` des Backends welchen Satz bekommt.
  *
@@ -662,6 +744,13 @@ declare const BESCHRIFTUNGEN_ROH: {
     readonly 'pairing.pair_again': {
         readonly text: "Neu koppeln";
     };
+    readonly 'register.device_unnamed': {
+        readonly text: "Kasse";
+    };
+    readonly 'login.locked_seconds': {
+        readonly text: "Noch {seconds} s gesperrt";
+        readonly placeholders: readonly ["seconds"];
+    };
     readonly 'logout.question': {
         readonly text: "Wirklich abmelden?";
     };
@@ -731,6 +820,10 @@ declare const BESCHRIFTUNGEN_ROH: {
     readonly 'split.remaining': {
         readonly text: "Rest";
     };
+    readonly 'split.remaining_with_rounding': {
+        readonly text: "Rest inkl. Rundung {amount} ({cents} ct)";
+        readonly placeholders: readonly ["amount", "cents"];
+    };
     readonly 'split.divide': {
         readonly text: "÷ {n}";
         readonly placeholders: readonly ["n"];

package/dist/cjs/pos/texte.js

@@ -22,17 +22,32 @@
  * `placeholders` und `structure`).
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LABELS = exports.CANCELLATION_PAYMENT_ERROR_MESSAGES = exports.RECEIPT_EMAIL_ERROR_MESSAGES = exports.ERROR_RULES = exports.MESSAGES = void 0;
+exports.LABELS = exports.CANCELLATION_PAYMENT_ERROR_MESSAGES = exports.RECEIPT_EMAIL_ERROR_MESSAGES = exports.CALLS_WITH_EFFECT = exports.ERROR_OUTCOME_RULES = exports.ERROR_CODE_RULES = exports.ERROR_RULES = exports.MESSAGES = void 0;
+exports.findErrorRule = findErrorRule;
+exports.messageOutcome = messageOutcome;
 exports.receiptEmailErrorMessage = receiptEmailErrorMessage;
 exports.cancellationPaymentErrorMessage = cancellationPaymentErrorMessage;
 exports.labelText = labelText;
 exports.messageText = messageText;
 exports.messageAppliesTo = messageAppliesTo;
+const errors_js_1 = require("../client/errors.js");
 const MELDUNGEN_ROH = {
     // --- Transport -----------------------------------------------------------
     'network.no_connection': { text: 'Keine Verbindung zum Server. Bitte die Internetverbindung prüfen und erneut versuchen.' },
     'network.timeout': { text: 'Der Server antwortet nicht. Bitte die Internetverbindung prüfen und erneut versuchen.' },
+    // Frist oder Netzfehler auf einem Aufruf mit Wirkung (ERROR_OUTCOME_RULES):
+    // der Vorgang kann trotzdem gebucht sein, darum nie „erneut versuchen“.
+    'network.outcome_unknown': { text: 'Der Server hat nicht geantwortet, der Vorgang kann trotzdem gebucht sein. Bitte vor einem neuen Versuch prüfen, ob der letzte Vorgang schon gebucht ist.' },
     'server.unexpected': { text: 'Der Server hat unerwartet geantwortet (HTTP {status}). Bitte den Support verständigen.', placeholders: ['status'] },
+    // Rand-Codes, die ein Kassier nicht deuten kann (siehe ERROR_CODE_RULES): der
+    // technische Satz bleibt in `error.message`, auf den Schirm kommt dieser.
+    // Nur fuer Codes, bei denen der Server nichts ausgefuehrt hat: dann darf
+    // der Satz zum neuen Versuch raten.
+    'server.connection_disturbed': { text: 'Die Verbindung zum Kassenserver ist gestört. Bitte kurz warten und erneut versuchen.' },
+    // Codes mit unklarem Ausgang (der Vorgang kann gebucht sein): nie zum
+    // Wiederholen raten, erst nachsehen. „Kasse neu öffnen“ passt fuer beide
+    // Seiten (Web: neu laden, App: neu starten).
+    'server.response_unreadable': { text: 'Die Antwort des Kassenservers war nicht lesbar. Bitte die Kasse neu öffnen und vor einem neuen Versuch prüfen, ob der letzte Vorgang schon gebucht ist.' },
     // --- Kopplung ------------------------------------------------------------
     'pairing.code_missing': { text: 'Bitte den Kopplungs-Code eingeben.' },
     'pairing.failed': { text: 'Die Kopplung ist fehlgeschlagen. Bitte erneut versuchen.' },
@@ -271,8 +286,8 @@ const MELDUNGEN_ROH = {
 exports.MESSAGES = MELDUNGEN_ROH;
 /**
  * In welcher Reihenfolge ein Fehler eingeordnet wird, auf beiden Seiten
- * dieselbe. Jede Regel nennt ihre Art (`kind`) und entweder ein Verhalten
- * (`behavior`) oder den Schluessel des Satzes (`key`). Die Arten:
+ * dieselbe. Genau eine Regel je Art (`kind`), mit einem Verhalten
+ * (`behavior`) oder dem Schluessel des Satzes (`key`). Die Arten:
  *   api        - HTTP 200, `status:'error'`: der Satz des Backends, woertlich
  *                (`server_text`)
  *   plain_text - schon fuer den Bildschirm geschrieben: sein eigener Text
@@ -285,6 +300,11 @@ exports.MESSAGES = MELDUNGEN_ROH;
  *                (`fallback`)
  * Unter 0.x hiessen sie `klartext`, `zeitablauf`, `netz`, `unerwartet`,
  * `sonst` (Tabelle in `fixtures/renames-1.0.json`).
+ *
+ * Seit 1.0.0-rc.5 verfeinern [ERROR_CODE_RULES] und [ERROR_OUTCOME_RULES]
+ * diese Liste; sie stehen bewusst getrennt, damit ein Leser, der nur nach
+ * `kind` sucht, weiter genau den Satz von rc.4 zeigt. [findErrorRule] wendet
+ * alle drei in der richtigen Reihenfolge an.
  */
 exports.ERROR_RULES = [
     { kind: 'api', behavior: 'server_text' },
@@ -294,6 +314,87 @@ exports.ERROR_RULES = [
     { kind: 'unexpected', key: 'server.unexpected' },
     { kind: 'other', behavior: 'fallback' },
 ];
+/**
+ * Regeln je Code (`error.code`), vor der Regel der Art: sie ersetzen den
+ * technischen Satz des Pakets bzw. des Rands durch einen Menschentext. Der
+ * technische Satz bleibt in `error.message` fuers Protokoll.
+ *   - `dialect_mismatch`, `response_translation_failed`, `response_unreadable`:
+ *     Ausgang unklar, der Vorgang kann gebucht sein; der Satz raet nie zum
+ *     Wiederholen, sondern zum Nachsehen.
+ *   - `route_missing`, `not_found`, `internal_translation_error`: am Server
+ *     geschah nichts, ein neuer Versuch ist sicher (auch auf den Geldwegen:
+ *     alle drei stehen in `PAYMENT_CALL_REJECTED_CODES`).
+ */
+exports.ERROR_CODE_RULES = [
+    { kind: 'api', codes: ['dialect_mismatch', 'response_translation_failed', 'response_unreadable'], key: 'server.response_unreadable' },
+    { kind: 'api', codes: ['route_missing', 'not_found', 'internal_translation_error'], key: 'server.connection_disturbed' },
+];
+/**
+ * Regeln je Ausgang, nach den Code-Regeln und vor der Regel der Art: eine
+ * Frist oder ein Netzfehler auf einem Aufruf mit Wirkung (Ausgang unklar,
+ * siehe [messageOutcome]) raet nie zum Wiederholen. Ein Netzfehler auf einem
+ * Aufruf ohne Wirkung behaelt den Satz von rc.4 („erneut versuchen“).
+ */
+exports.ERROR_OUTCOME_RULES = [
+    { kind: 'timeout', outcome: 'unknown', key: 'network.outcome_unknown' },
+    { kind: 'network', outcome: 'unknown', key: 'network.outcome_unknown' },
+];
+/**
+ * Die Regel fuer einen Fehler: zuerst eine Code-Regel mit passender Art und
+ * passendem `code`, dann eine Ausgangs-Regel mit passender Art und
+ * passendem `outcome`, sonst die Regel der Art aus [ERROR_RULES]. Beide
+ * Kassen ordnen so ein.
+ */
+function findErrorRule(kind, detail = {}) {
+    const { code, outcome } = detail;
+    if (code !== undefined && code !== null) {
+        const treffer = exports.ERROR_CODE_RULES.find((r) => r.kind === kind && r.codes.includes(code));
+        if (treffer)
+            return treffer;
+    }
+    if (outcome !== undefined && outcome !== null) {
+        const treffer = exports.ERROR_OUTCOME_RULES.find((r) => r.kind === kind && r.outcome === outcome);
+        if (treffer)
+            return treffer;
+    }
+    // Jede Art hat genau eine Regel; hierher kommt nur eine fremde Art nicht.
+    return exports.ERROR_RULES.find((r) => r.kind === kind) ?? exports.ERROR_RULES[exports.ERROR_RULES.length - 1];
+}
+/**
+ * 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.
+ */
+exports.CALLS_WITH_EFFECT = Object.freeze([
+    'createReceipt',
+    'cancelReceipt',
+    'financeWebService',
+    'hobexPayApi',
+    'hobexRefundApi',
+    'stripeCaptureIntent',
+    'createPrintJob',
+    'sendReceiptEmail',
+]);
+const MIT_WIRKUNG = new Set(exports.CALLS_WITH_EFFECT);
+/**
+ * Der Ausgang, nach dem der Satz gewaehlt wird: `'unknown'`, wenn das Paket
+ * ihn als unklar fuehrt ([isOutcomeUnknown]) oder wenn eine Frist bzw. ein
+ * Netzfehler einen Aufruf aus [CALLS_WITH_EFFECT] traf; sonst der Ausgang
+ * des Fehlers (`'rejected'`) bzw. `undefined` fuer fremde Fehler.
+ */
+function messageOutcome(error) {
+    if ((0, errors_js_1.isOutcomeUnknown)(error))
+        return 'unknown';
+    if (error instanceof errors_js_1.KasseneckNetworkError)
+        return MIT_WIRKUNG.has(error.functionName.split('/')[0]) ? 'unknown' : error.outcome;
+    if (error instanceof errors_js_1.KasseneckApiError || error instanceof errors_js_1.KasseneckHttpError)
+        return error.outcome;
+    return undefined;
+}
 /**
  * Beleg per E-Mail senden: welcher `code` des Backends welchen Satz bekommt.
  *
@@ -377,6 +478,10 @@ const BESCHRIFTUNGEN_ROH = {
     'message.dismiss_warning': { text: 'Verstanden – Warnung ausblenden: {message}', placeholders: ['message'] },
     // --- Kopplung und Abmelden -----------------------------------------------
     'pairing.pair_again': { text: 'Neu koppeln' },
+    // Ein Geraet ohne Namen (`deviceLabel: null` unter /v3) in der Auswahl.
+    'register.device_unnamed': { text: 'Kasse' },
+    // Restzeit der PIN-Sperre unter dem Satz des Backends.
+    'login.locked_seconds': { text: 'Noch {seconds} s gesperrt', placeholders: ['seconds'] },
     'logout.question': { text: 'Wirklich abmelden?' },
     'logout.keep_working': { text: 'Weiter arbeiten' },
     'device.unpair': { text: 'Gerät entkoppeln' },
@@ -405,6 +510,9 @@ const BESCHRIFTUNGEN_ROH = {
     'split.payment': { text: 'Zahlung {n}', placeholders: ['n'] },
     'split.amount': { text: 'Betrag' },
     'split.remaining': { text: 'Rest' },
+    // Letzte Runde bei Getrennt zahlen: der Rest samt Rundungscent;
+    // `{cents}` traegt das Vorzeichen (`+1`, `−1`).
+    'split.remaining_with_rounding': { text: 'Rest inkl. Rundung {amount} ({cents} ct)', placeholders: ['amount', 'cents'] },
     'split.divide': { text: '÷ {n}', placeholders: ['n'] },
     'split.tip_basis': { text: '% von diesem Betrag' },
     'split.of_which_tip': { text: 'davon Trinkgeld {amount}', placeholders: ['amount'] },

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

@@ -33,6 +33,10 @@ import type { Voucher } from '../models/voucher.js';
  * rabattiert). Das weiss nur die Kasse; darum ist `tipRecipient` Pflicht,
  * sobald Trinkgeld ohne `recipients` vorkommt. Ohne angemeldeten Benutzer
  * (Geraete-Schluessel) gilt `'staff'`.
+ *
+ * **Nicht rechenbar:** jede unbrauchbare Eingabe wirft [ReceiptDueError]
+ * (`code: 'receipt_due_unavailable'`, `reason` im Einzelnen), nie still eine
+ * falsche Zahl. Dann ist nichts gesendet.
  */
 /** Wer das Trinkgeld ohne `recipients` bekommt (Kennzeichen des angemeldeten Kassen-Benutzers). */
 export type ReceiptDueTipRecipient = 'owner' | 'staff';
@@ -78,6 +82,35 @@ export interface ReceiptDueBreakdown {
     /** Toepfe je auf Cent gerundet; `null` bei Start- und Nullbeleg. */
     bucketsCents: ReceiptDueBuckets | null;
 }
+/**
+ * Warum sich der Zahlbetrag nicht rechnen laesst. Fest wie ein Backend-Code;
+ * dieselbe Liste im Dart-Zwilling und in `fixtures/receipt-due-errors.json`.
+ */
+export declare const RECEIPT_DUE_ERROR_REASONS: readonly ["unknown_receipt_type", "tip_not_allowed", "invalid_item", "invalid_voucher", "invalid_tip", "unknown_payment_method", "tip_conflict", "tip_recipient_missing", "tip_without_goods"];
+export type ReceiptDueErrorReason = (typeof RECEIPT_DUE_ERROR_REASONS)[number];
+/**
+ * Der Zahlbetrag laesst sich aus dieser Eingabe nicht rechnen, etwa
+ * Trinkgeld mit Betrag ohne Ware (`reason: 'tip_without_goods'`).
+ *
+ * Eindeutig **nicht gesendet**: die Rechnung laeuft ganz im Paket, vor jedem
+ * Aufruf. `outcome` ist darum immer `'rejected'`; nichts ist geschehen, keine
+ * Belegnummer verbraucht, keine Karte belastet. Die Kasse sagt das dem
+ * Kassier, bevor sie ein Terminal anspricht. Entscheiden am `code` bzw.
+ * `reason`, nie an `message` (die ist fuers Protokoll).
+ *
+ * Bis 1.0.0-rc.4 warf die Rechnung hier einen `RangeError` ohne Code.
+ */
+export declare class ReceiptDueError extends Error {
+    readonly name = "ReceiptDueError";
+    /** Stabiler Code fuer jede Ursache. */
+    readonly code: "receipt_due_unavailable";
+    /** Die Ursache im Einzelnen. */
+    readonly reason: ReceiptDueErrorReason;
+    /** Immer `'rejected'`: es ging nichts hinaus. */
+    readonly outcome: "rejected";
+    constructor(reason: ReceiptDueErrorReason, message: string);
+}
+export declare function isReceiptDueError(error: unknown): error is ReceiptDueError;
 type BelegArt = ReceiptType | ReceiptTypeKey | string;
 /** Zahlbetrag in Cent, siehe Modulkommentar. */
 export declare function receiptDueCents(items: readonly ReceiptItem[], vouchers: readonly Voucher[], receiptType: BelegArt, options?: ReceiptDueOptions): number;