@kreiseck/kasseneck-api 1.10.1 → 1.11.0

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

@@ -1,11 +1,12 @@
 /**
  * Kachel-Kasse: Einstellungen, Artikelgruppen/Artikel fuer Kacheln,
  * Rabattverteilung, Drucker, Trinkgeld-Empfaenger, Lager (Standorte, Bestand,
- * Standort der Kasse), Inventur zaehlen. Die Aufrufe heissen 1:1 wie
+ * Standort der Kasse), Inventur zaehlen, Schicht, Kassenstand und
+ * Lade-Protokoll mit ihren Bons. Die Aufrufe heissen 1:1 wie
  * die Backend-Functions (die Rewrites-Waechter der Web-App leiten daraus ab)
  * und sprechen den Kassenweg `/api/v3` (Schluessel und Werte englisch).
  */
-export { type PosTheme, type PosFontSize, type PosWatermark, type PosQuantity, type PosTipMode, type PosCheckoutMode, type PosCardProvider, type PosReceiptOutput, type PosShortcutAction, type PosShortcutMap, POS_SHORTCUT_ACTIONS, POS_SHORTCUT_DEFAULTS, type PosLayout, type PosCategoryPosition, type PosTileHeight, type PosPrinterType, type PosTerminalVia, type PosTerminalType, type PosPaperSize, type PosCodePage, type PosCut, type PosDrawerAutoOpen, type PosQrMode, type PosLogoSize, type PosSettingsFontSize, type PosTileStyle, type PosAutoLogoutMinutes, type PosDiscount, type PosWatermarkSide, type PosWatermarkStrength, type PosLogoScale, type PosWatermarkScale, type PosDoneScreenSeconds, type PosToggleMap, type PosBusinessSettings, type PosDeviceSettings, type PosSettings, POS_BUSINESS_DEFAULTS, POS_DEVICE_DEFAULTS, POS_BUSINESS_VALUES, POS_DEVICE_VALUES, mergePosSettings, sanitizePosSettings, unknownPosSettingValues, posSettingsChanges, type PosOpen, POS_SHORTCUT_SHARED_PAIRS, posShortcutConflict, THEME, FONT_SIZE, WATERMARK, QUANTITY, TIP_MODE, CHECKOUT_MODE, CARD_PROVIDER, RECEIPT_OUTPUT, LAYOUT, CATEGORY_POSITION, TILE_HEIGHT, PRINTER_TYPE, TERMINAL_VIA, TERMINAL_TYPE, PAPER_SIZE, CODE_PAGE, CUT, DRAWER_AUTO_OPEN, QR_MODE, LOGO_SIZE, SETTINGS_FONT_SIZE, TILE_STYLE, AUTO_LOGOUT_MINUTES, DISCOUNT, WATERMARK_SIDE, WATERMARK_STRENGTH, LOGO_SCALE, WATERMARK_SCALE, DONE_SCREEN_SECONDS, } from './settings.js';
+export { type PosTheme, type PosFontSize, type PosWatermark, type PosQuantity, type PosTipMode, type PosCheckoutMode, type PosCardProvider, type PosReceiptOutput, type PosShortcutAction, type PosShortcutMap, POS_SHORTCUT_ACTIONS, POS_SHORTCUT_DEFAULTS, type PosLayout, type PosCategoryPosition, type PosTileHeight, type PosPrinterType, type PosTerminalVia, type PosTerminalType, type PosPaperSize, type PosCodePage, type PosCut, type PosDrawerAutoOpen, type PosQrMode, type PosLogoSize, type PosSettingsFontSize, type PosTileStyle, type PosAutoLogoutMinutes, type PosDiscount, type PosWatermarkSide, type PosWatermarkStrength, type PosLogoScale, type PosWatermarkScale, type PosDoneScreenSeconds, type PosToggleMap, type PosBusinessSettings, type PosDeviceSettings, type PosSettings, POS_BUSINESS_DEFAULTS, POS_DEVICE_DEFAULTS, POS_DEVICE_OPTIONAL_FIELDS, POS_BUSINESS_OPTIONAL_FIELDS, posTipKeptByDefault, POS_BUSINESS_VALUES, POS_DEVICE_VALUES, mergePosSettings, sanitizePosSettings, unknownPosSettingValues, posSettingsChanges, type PosOpen, POS_SHORTCUT_SHARED_PAIRS, posShortcutConflict, THEME, FONT_SIZE, WATERMARK, QUANTITY, TIP_MODE, CHECKOUT_MODE, CARD_PROVIDER, RECEIPT_OUTPUT, LAYOUT, CATEGORY_POSITION, TILE_HEIGHT, PRINTER_TYPE, TERMINAL_VIA, TERMINAL_TYPE, PAPER_SIZE, CODE_PAGE, CUT, DRAWER_AUTO_OPEN, QR_MODE, LOGO_SIZE, SETTINGS_FONT_SIZE, TILE_STYLE, AUTO_LOGOUT_MINUTES, DISCOUNT, WATERMARK_SIDE, WATERMARK_STRENGTH, LOGO_SCALE, WATERMARK_SCALE, DONE_SCREEN_SECONDS, } from './settings.js';
 export { type ArticleGroup, type ArticleGroupPayload, fromArticleGroupPayload, type PosArticle, type PosArticlePayload, fromPosArticlePayload, listMyArticleGroups, listMyArticles, QUANTITY_RULES, type QuantityRule, type QuantityDefaults, quantityRuleForUnit, quantityDefaults, allowedQuantity, } from './artikel.js';
 export { getPosSettings, setMyPosSettings, setMyRegisterDeviceSettings, setMyPosLogo, posSettingsFromWire, type SetMyPosLogoOptions, } from './client.js';
 export { POS_ERROR_CODES, type PosErrorCode, isPosErrorCode, posErrorCode, isPosError, type PosFieldError, posFieldErrors, } from './errors.js';
@@ -17,5 +18,8 @@ export { STOCK_LOCATION_TYPES, type StockLocationType, type StockLocation, type
 export { type ListMyStocktakesOptions, type ListMyStocktakeItemsOptions, type ListMyStocktakeCountsOptions, type RecordMyStocktakeCountOptions, type VoidMyStocktakeCountOptions, listMyStocktakes, listMyStocktakeItems, listMyStocktakeCounts, recordMyStocktakeCount, voidMyStocktakeCount, parseQuantityMilli, } from './inventur.js';
 export type { Stocktake, StocktakeItem, StocktakeCount, StocktakeCountResult, StocktakeItemPage, StocktakeCountPage, StocktakeActor, StocktakeProgress, StocktakeReview, StocktakeRecount, StocktakeScope, } from '../inventory/typen.js';
 export type { StocktakeStatus } from '../inventory/vertrag.js';
+export { type GetMyDrawerStateOptions, type OpenMyShiftOptions, type RecordMyCashMovementOptions, type DrawerOpeningEntry, type LogMyDrawerOpeningsOptions, type GetMyShiftReportOptions, type TipPayout, type CloseMyShiftOptions, type AfterCountOption, getMyDrawerState, openMyShift, recordMyCashMovement, logMyDrawerOpenings, getMyShiftReport, closeMyShift, sumDenominations, parseCentsAllowZero, newIdempotencyKey, shiftTipLines, durationText, type ShiftTipLine, type ShiftTipLineKey, } from './schicht.js';
+export { EUR_DENOMINATIONS, MOVEMENT_TYPES, MANUAL_MOVEMENT_TYPES, CASH_LOCATIONS, OPENING_REASONS, MANUAL_OPENING_REASONS, SHIFT_RECEIPT_KINDS, AFTER_COUNT_TYPES, type AfterCountType, type AfterCount, type EurDenomination, type MovementType, type ManualMovementType, type CashLocation, type OpeningReason, type ManualOpeningReason, type ShiftReceiptKind, type ShiftStatus, type ShiftActorRole, type Denominations, type ShiftActor, type DrawerInfo, type DrawerRights, type NonCashAmount, type ShiftTipTotals, type ShiftTip, type ShiftRunningTotals, type ShiftReconciliation, type Shift, type TipClaim, type DrawerOpening, type DrawerState, type CashMovement, type ShiftReceiptHeader, type ShiftReceiptMovement, type ShiftReceiptTip, type ShiftSummaryReceipt, type CashMovementReceipt, type ShiftReceipt, type OpenShiftResult, type CashMovementResult, type DrawerOpeningsResult, type ShiftReport, type CloseShiftResult, } from './schicht-typen.js';
+export { type ShiftReceiptLayoutOptions, shiftReceiptLayout, cashMovementLayout } from '../receipt/shift-sheet.js';
 export { RETURN_DISPOSITIONS, isReturnDisposition, type ReturnDisposition } from '../models/cancellation.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, RETURN_DISPOSITION_LABELS, 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,11 +1,13 @@
 "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.RETURN_DISPOSITION_LABELS = 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.isReturnDisposition = exports.RETURN_DISPOSITIONS = exports.parseQuantityMilli = exports.voidMyStocktakeCount = exports.recordMyStocktakeCount = exports.listMyStocktakeCounts = exports.listMyStocktakeItems = exports.listMyStocktakes = exports.setMyCashregisterStockLocation = exports.listMyStock = exports.listMyStockLocations = exports.STOCK_LOCATION_TYPES = exports.listMyTipRecipients = exports.getPrintJob = exports.createPrintJob = exports.listMyPrinters = exports.isPrintJobFinished = exports.PRINT_JOB_SOURCES = exports.PRINT_JOB_STATUSES = exports.stockViewOf = 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.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.posTipKeptByDefault = exports.POS_BUSINESS_OPTIONAL_FIELDS = exports.POS_DEVICE_OPTIONAL_FIELDS = exports.POS_DEVICE_DEFAULTS = exports.POS_BUSINESS_DEFAULTS = exports.POS_SHORTCUT_DEFAULTS = exports.POS_SHORTCUT_ACTIONS = void 0;
+exports.MANUAL_OPENING_REASONS = exports.OPENING_REASONS = exports.CASH_LOCATIONS = exports.MANUAL_MOVEMENT_TYPES = exports.MOVEMENT_TYPES = exports.EUR_DENOMINATIONS = exports.durationText = exports.shiftTipLines = exports.newIdempotencyKey = exports.parseCentsAllowZero = exports.sumDenominations = exports.closeMyShift = exports.getMyShiftReport = exports.logMyDrawerOpenings = exports.recordMyCashMovement = exports.openMyShift = exports.getMyDrawerState = exports.parseQuantityMilli = exports.voidMyStocktakeCount = exports.recordMyStocktakeCount = exports.listMyStocktakeCounts = exports.listMyStocktakeItems = exports.listMyStocktakes = exports.setMyCashregisterStockLocation = exports.listMyStock = exports.listMyStockLocations = exports.STOCK_LOCATION_TYPES = exports.listMyTipRecipients = exports.getPrintJob = exports.createPrintJob = exports.listMyPrinters = exports.isPrintJobFinished = exports.PRINT_JOB_SOURCES = exports.PRINT_JOB_STATUSES = exports.stockViewOf = 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 = exports.getPosSettings = exports.allowedQuantity = exports.quantityDefaults = void 0;
+exports.RETURN_DISPOSITION_LABELS = 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.isReturnDisposition = exports.RETURN_DISPOSITIONS = exports.cashMovementLayout = exports.shiftReceiptLayout = exports.AFTER_COUNT_TYPES = exports.SHIFT_RECEIPT_KINDS = void 0;
 /**
  * Kachel-Kasse: Einstellungen, Artikelgruppen/Artikel fuer Kacheln,
  * Rabattverteilung, Drucker, Trinkgeld-Empfaenger, Lager (Standorte, Bestand,
- * Standort der Kasse), Inventur zaehlen. Die Aufrufe heissen 1:1 wie
+ * Standort der Kasse), Inventur zaehlen, Schicht, Kassenstand und
+ * Lade-Protokoll mit ihren Bons. Die Aufrufe heissen 1:1 wie
  * die Backend-Functions (die Rewrites-Waechter der Web-App leiten daraus ab)
  * und sprechen den Kassenweg `/api/v3` (Schluessel und Werte englisch).
  */
@@ -14,6 +16,9 @@ Object.defineProperty(exports, "POS_SHORTCUT_ACTIONS", { enumerable: true, get:
 Object.defineProperty(exports, "POS_SHORTCUT_DEFAULTS", { enumerable: true, get: function () { return settings_js_1.POS_SHORTCUT_DEFAULTS; } });
 Object.defineProperty(exports, "POS_BUSINESS_DEFAULTS", { enumerable: true, get: function () { return settings_js_1.POS_BUSINESS_DEFAULTS; } });
 Object.defineProperty(exports, "POS_DEVICE_DEFAULTS", { enumerable: true, get: function () { return settings_js_1.POS_DEVICE_DEFAULTS; } });
+Object.defineProperty(exports, "POS_DEVICE_OPTIONAL_FIELDS", { enumerable: true, get: function () { return settings_js_1.POS_DEVICE_OPTIONAL_FIELDS; } });
+Object.defineProperty(exports, "POS_BUSINESS_OPTIONAL_FIELDS", { enumerable: true, get: function () { return settings_js_1.POS_BUSINESS_OPTIONAL_FIELDS; } });
+Object.defineProperty(exports, "posTipKeptByDefault", { enumerable: true, get: function () { return settings_js_1.posTipKeptByDefault; } });
 Object.defineProperty(exports, "POS_BUSINESS_VALUES", { enumerable: true, get: function () { return settings_js_1.POS_BUSINESS_VALUES; } });
 Object.defineProperty(exports, "POS_DEVICE_VALUES", { enumerable: true, get: function () { return settings_js_1.POS_DEVICE_VALUES; } });
 Object.defineProperty(exports, "mergePosSettings", { enumerable: true, get: function () { return settings_js_1.mergePosSettings; } });
@@ -102,6 +107,31 @@ Object.defineProperty(exports, "listMyStocktakeCounts", { enumerable: true, get:
 Object.defineProperty(exports, "recordMyStocktakeCount", { enumerable: true, get: function () { return inventur_js_1.recordMyStocktakeCount; } });
 Object.defineProperty(exports, "voidMyStocktakeCount", { enumerable: true, get: function () { return inventur_js_1.voidMyStocktakeCount; } });
 Object.defineProperty(exports, "parseQuantityMilli", { enumerable: true, get: function () { return inventur_js_1.parseQuantityMilli; } });
+// Schicht, Kassenstand und Lade-Protokoll (1.9.0): Aufrufe, Kataloge, Helfer, Bons.
+var schicht_js_1 = require("./schicht.js");
+Object.defineProperty(exports, "getMyDrawerState", { enumerable: true, get: function () { return schicht_js_1.getMyDrawerState; } });
+Object.defineProperty(exports, "openMyShift", { enumerable: true, get: function () { return schicht_js_1.openMyShift; } });
+Object.defineProperty(exports, "recordMyCashMovement", { enumerable: true, get: function () { return schicht_js_1.recordMyCashMovement; } });
+Object.defineProperty(exports, "logMyDrawerOpenings", { enumerable: true, get: function () { return schicht_js_1.logMyDrawerOpenings; } });
+Object.defineProperty(exports, "getMyShiftReport", { enumerable: true, get: function () { return schicht_js_1.getMyShiftReport; } });
+Object.defineProperty(exports, "closeMyShift", { enumerable: true, get: function () { return schicht_js_1.closeMyShift; } });
+Object.defineProperty(exports, "sumDenominations", { enumerable: true, get: function () { return schicht_js_1.sumDenominations; } });
+Object.defineProperty(exports, "parseCentsAllowZero", { enumerable: true, get: function () { return schicht_js_1.parseCentsAllowZero; } });
+Object.defineProperty(exports, "newIdempotencyKey", { enumerable: true, get: function () { return schicht_js_1.newIdempotencyKey; } });
+Object.defineProperty(exports, "shiftTipLines", { enumerable: true, get: function () { return schicht_js_1.shiftTipLines; } });
+Object.defineProperty(exports, "durationText", { enumerable: true, get: function () { return schicht_js_1.durationText; } });
+var schicht_typen_js_1 = require("./schicht-typen.js");
+Object.defineProperty(exports, "EUR_DENOMINATIONS", { enumerable: true, get: function () { return schicht_typen_js_1.EUR_DENOMINATIONS; } });
+Object.defineProperty(exports, "MOVEMENT_TYPES", { enumerable: true, get: function () { return schicht_typen_js_1.MOVEMENT_TYPES; } });
+Object.defineProperty(exports, "MANUAL_MOVEMENT_TYPES", { enumerable: true, get: function () { return schicht_typen_js_1.MANUAL_MOVEMENT_TYPES; } });
+Object.defineProperty(exports, "CASH_LOCATIONS", { enumerable: true, get: function () { return schicht_typen_js_1.CASH_LOCATIONS; } });
+Object.defineProperty(exports, "OPENING_REASONS", { enumerable: true, get: function () { return schicht_typen_js_1.OPENING_REASONS; } });
+Object.defineProperty(exports, "MANUAL_OPENING_REASONS", { enumerable: true, get: function () { return schicht_typen_js_1.MANUAL_OPENING_REASONS; } });
+Object.defineProperty(exports, "SHIFT_RECEIPT_KINDS", { enumerable: true, get: function () { return schicht_typen_js_1.SHIFT_RECEIPT_KINDS; } });
+Object.defineProperty(exports, "AFTER_COUNT_TYPES", { enumerable: true, get: function () { return schicht_typen_js_1.AFTER_COUNT_TYPES; } });
+var shift_sheet_js_1 = require("../receipt/shift-sheet.js");
+Object.defineProperty(exports, "shiftReceiptLayout", { enumerable: true, get: function () { return shift_sheet_js_1.shiftReceiptLayout; } });
+Object.defineProperty(exports, "cashMovementLayout", { enumerable: true, get: function () { return shift_sheet_js_1.cashMovementLayout; } });
 // Rueckgabe-Wahl beim Storno (Kassen-Dialog); dieselbe Liste wie an der Wurzel.
 var cancellation_js_1 = require("../models/cancellation.js");
 Object.defineProperty(exports, "RETURN_DISPOSITIONS", { enumerable: true, get: function () { return cancellation_js_1.RETURN_DISPOSITIONS; } });

package/dist/cjs/pos/schicht-lesen.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Leser der Schicht-Antworten: aus dem Draht `/v3` werden die Modelle in
+ * `schicht-typen.ts`. Paketintern, nicht Teil der Oberflaeche.
+ *
+ * Regel wie beim Lager: ein Betrag, eine Anzahl oder eine Nummer ist eine
+ * Ganzzahl, eine Kennung ein nicht leerer Text, sonst endet der Aufruf mit
+ * `KasseneckValidationError`. Ein Ersatzwert wie `0` waere eine falsche
+ * Aussage („nichts in der Lade“ statt „Antwort kaputt“). Texte sind
+ * nachsichtiger: ein fehlender oder fremder Wert wird `null`.
+ *
+ * Felder, die nur mit Recht kommen (`expectedCents`, `runningTotals` …),
+ * stehen im Modell genau dann, wenn der Server sie sendet.
+ */
+import { type ValidationScope } from '../client/errors.js';
+import type { CashMovement, CashMovementReceipt, CashMovementResult, DrawerOpeningsResult, OpenShiftResult, ShiftReport, CloseShiftResult, DrawerState, Shift, ShiftSummaryReceipt } from './schicht-typen.js';
+type Roh = Record<string, unknown>;
+/** Wer liest (fuer die Meldung) und wo im Rumpf. */
+export interface Ort {
+    name: string;
+    pfad: string;
+    /** `response` fuer Antworten, `request` fuer Bon-Daten, die ein Aufrufer uebergibt. */
+    scope: ValidationScope;
+}
+/** Ein Objekt, das da sein muss. */
+export declare function pflichtObjekt(ort: Ort, w: unknown): Roh;
+/** Eine Schicht; was nur mit `cashView` kommt, steht nur, wenn gesendet. */
+export declare function schicht(ort: Ort, w: unknown): Shift;
+export declare function ladeStand(ort: Ort, w: unknown): DrawerState;
+export declare function bewegung(ort: Ort, w: unknown): CashMovement;
+/** Bon-Daten eines Z- oder X-Bons; eine andere Art ist ein Fehler. */
+export declare function schichtBon(ort: Ort, w: unknown): ShiftSummaryReceipt;
+/** Bon-Daten einer Kassenbewegung; eine andere Art ist ein Fehler. */
+export declare function bewegungsBon(ort: Ort, w: unknown): CashMovementReceipt;
+export declare function abschluss(ort: Ort, w: unknown): CloseShiftResult;
+export declare function geoeffnet(ort: Ort, w: unknown): OpenShiftResult;
+export declare function gebucht(ort: Ort, w: unknown): CashMovementResult;
+export declare function gemeldet(ort: Ort, w: unknown): DrawerOpeningsResult;
+export declare function bericht(ort: Ort, w: unknown): ShiftReport;
+export {};

package/dist/cjs/pos/schicht-lesen.js

@@ -0,0 +1,405 @@
+"use strict";
+/**
+ * Leser der Schicht-Antworten: aus dem Draht `/v3` werden die Modelle in
+ * `schicht-typen.ts`. Paketintern, nicht Teil der Oberflaeche.
+ *
+ * Regel wie beim Lager: ein Betrag, eine Anzahl oder eine Nummer ist eine
+ * Ganzzahl, eine Kennung ein nicht leerer Text, sonst endet der Aufruf mit
+ * `KasseneckValidationError`. Ein Ersatzwert wie `0` waere eine falsche
+ * Aussage („nichts in der Lade“ statt „Antwort kaputt“). Texte sind
+ * nachsichtiger: ein fehlender oder fremder Wert wird `null`.
+ *
+ * Felder, die nur mit Recht kommen (`expectedCents`, `runningTotals` …),
+ * stehen im Modell genau dann, wenn der Server sie sendet.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pflichtObjekt = pflichtObjekt;
+exports.schicht = schicht;
+exports.ladeStand = ladeStand;
+exports.bewegung = bewegung;
+exports.schichtBon = schichtBon;
+exports.bewegungsBon = bewegungsBon;
+exports.abschluss = abschluss;
+exports.geoeffnet = geoeffnet;
+exports.gebucht = gebucht;
+exports.gemeldet = gemeldet;
+exports.bericht = bericht;
+const errors_js_1 = require("../client/errors.js");
+const schicht_typen_js_1 = require("./schicht-typen.js");
+const hat = (o, k) => Object.prototype.hasOwnProperty.call(o, k);
+const unter = (ort, teil) => ({ ...ort, pfad: ort.pfad === '' ? teil : `${ort.pfad}.${teil}` });
+function fehler(ort, grund) {
+    return new errors_js_1.KasseneckValidationError(ort.name, `${ort.scope === 'response' ? 'Antwort' : 'Bon-Daten'}: ${grund}`, ort.scope);
+}
+function objekt(w) {
+    return w !== null && typeof w === 'object' && !Array.isArray(w) ? w : null;
+}
+/** Ein Objekt, das da sein muss. */
+function pflichtObjekt(ort, w) {
+    const o = objekt(w);
+    if (!o)
+        throw fehler(ort, `${ort.pfad || 'data'} ist kein Objekt`);
+    return o;
+}
+const text = (w) => (typeof w === 'string' ? w : null);
+function kennung(ort, o, feld) {
+    const w = o[feld];
+    if (typeof w !== 'string' || w === '')
+        throw fehler(ort, `${ort.pfad}.${feld} fehlt`);
+    return w;
+}
+function ganzzahl(ort, o, feld) {
+    const w = o[feld];
+    if (typeof w !== 'number' || !Number.isSafeInteger(w))
+        throw fehler(ort, `${ort.pfad}.${feld} ist keine ganze Zahl`);
+    return w;
+}
+function ganzzahlOderNull(ort, o, feld) {
+    const w = o[feld];
+    return w === undefined || w === null ? null : ganzzahl(ort, o, feld);
+}
+function wahr(ort, o, feld) {
+    const w = o[feld];
+    if (typeof w !== 'boolean')
+        throw fehler(ort, `${ort.pfad}.${feld} ist kein Wahrheitswert`);
+    return w;
+}
+function wahrOderNull(ort, o, feld) {
+    const w = o[feld];
+    return w === undefined || w === null ? null : wahr(ort, o, feld);
+}
+function liste(ort, o, feld, lese) {
+    const w = o[feld];
+    if (!Array.isArray(w))
+        throw fehler(ort, `${ort.pfad}.${feld} ist keine Liste`);
+    return w.map((e, i) => lese(unter(ort, `${feld}[${i}]`), e));
+}
+/** Setzt ein Feld nur, wenn der Server es sendet (Recht). */
+function wennDa(ziel, o, feld, lese) {
+    if (hat(o, feld))
+        ziel[feld] = lese();
+}
+/** Setzt ein Feld nur, wenn der Server einen Wert sendet; `null` gilt wie fehlend. */
+function wennWert(ziel, o, feld, lese) {
+    if (o[feld] !== undefined && o[feld] !== null)
+        ziel[feld] = lese();
+}
+function stueckelung(ort, o, feld) {
+    const w = o[feld];
+    if (w === undefined || w === null)
+        return null;
+    const karte = objekt(w);
+    if (!karte)
+        throw fehler(ort, `${ort.pfad}.${feld} ist keine Stueckelung`);
+    const raus = {};
+    for (const k of Object.keys(karte))
+        raus[k] = ganzzahl(unter(ort, feld), karte, k);
+    return raus;
+}
+function akteur(ort, w) {
+    if (w === undefined || w === null)
+        return null;
+    const o = pflichtObjekt(ort, w);
+    return { registerUserId: text(o.registerUserId), name: text(o.name), role: text(o.role) ?? '' };
+}
+function unbar(ort, w) {
+    const o = pflichtObjekt(ort, w);
+    return { method: kennung(ort, o, 'method'), cents: ganzzahl(ort, o, 'cents') };
+}
+function trinkgeld(ort, w) {
+    const o = pflichtObjekt(ort, w);
+    return {
+        registerUserId: kennung(ort, o, 'registerUserId'),
+        name: text(o.name),
+        receivedImmediatelyCents: ganzzahl(ort, o, 'receivedImmediatelyCents'),
+        retainedCents: ganzzahl(ort, o, 'retainedCents'),
+        paidOutCents: ganzzahl(ort, o, 'paidOutCents'),
+        // Fehlt bei einem Backend vor der Regel R62: dann 0, statt die ganze Antwort zu verwerfen.
+        refundedByEmployeeCents: o.refundedByEmployeeCents === undefined || o.refundedByEmployeeCents === null ? 0 : ganzzahl(ort, o, 'refundedByEmployeeCents'),
+    };
+}
+/** Trinkgeld mit offenem Anspruch (Kassenstand, Bon). */
+function trinkgeldMitOffen(ort, w) {
+    const o = pflichtObjekt(ort, w);
+    return {
+        ...trinkgeld(ort, o),
+        // Fehlt bei einem Backend vor der Regel R64: dann 0.
+        carriedOverCents: o.carriedOverCents === undefined || o.carriedOverCents === null ? 0 : ganzzahl(ort, o, 'carriedOverCents'),
+        openCents: ganzzahl(ort, o, 'openCents'),
+    };
+}
+function laufstand(ort, w) {
+    const o = pflichtObjekt(ort, w);
+    return {
+        cashSalesCents: ganzzahl(ort, o, 'cashSalesCents'),
+        cashCancellationsCents: ganzzahl(ort, o, 'cashCancellationsCents'),
+        nonCashByMethod: liste(ort, o, 'nonCashByMethod', unbar),
+        // Fehlt bei einem Server vor dem Gutschein-Feld: dann 0.
+        voucherRedeemedCents: o.voucherRedeemedCents === undefined || o.voucherRedeemedCents === null ? 0 : ganzzahl(ort, o, 'voucherRedeemedCents'),
+        receiptCount: ganzzahl(ort, o, 'receiptCount'),
+        cancellationCount: ganzzahl(ort, o, 'cancellationCount'),
+        cashInCents: ganzzahl(ort, o, 'cashInCents'),
+        cashOutCents: ganzzahl(ort, o, 'cashOutCents'),
+        tips: liste(ort, o, 'tips', trinkgeld),
+        openingsWithoutSale: ganzzahl(ort, o, 'openingsWithoutSale'),
+    };
+}
+/** Entnehmen oder Einlegen nach dem Zaehlen; die Art bleibt offen fuer kuenftige Werte (Text). */
+function nachZaehlung(ort, w) {
+    const o = pflichtObjekt(ort, w);
+    return { type: kennung(ort, o, 'type'), amountCents: ganzzahl(ort, o, 'amountCents') };
+}
+function abgleich(ort, w) {
+    if (w === undefined || w === null)
+        return null;
+    const o = pflichtObjekt(ort, w);
+    const abw = o.deviations;
+    let deviations = null;
+    if (abw !== undefined && abw !== null) {
+        const karte = pflichtObjekt(unter(ort, 'deviations'), abw);
+        deviations = {};
+        for (const [feld, eintrag] of Object.entries(karte)) {
+            const e = pflichtObjekt(unter(ort, `deviations.${feld}`), eintrag);
+            deviations[feld] = { stored: e.stored, recomputed: e.recomputed };
+        }
+    }
+    return { matches: wahr(ort, o, 'matches'), deviations };
+}
+/** Eine Schicht; was nur mit `cashView` kommt, steht nur, wenn gesendet. */
+function schicht(ort, w) {
+    const o = pflichtObjekt(ort, w);
+    const status = o.status;
+    if (status !== 'open' && status !== 'closed')
+        throw fehler(ort, `${ort.pfad}.status ist unbekannt`);
+    const raus = {
+        id: kennung(ort, o, 'id'),
+        drawerId: kennung(ort, o, 'drawerId'),
+        cashregisterId: text(o.cashregisterId),
+        number: ganzzahl(ort, o, 'number'),
+        status,
+        openedAt: text(o.openedAt),
+        openedBy: akteur(unter(ort, 'openedBy'), o.openedBy),
+    };
+    const r = raus;
+    // Ohne Recht `shift` fehlen sie (Grunddaten der offenen Schicht).
+    wennDa(r, o, 'openedDeviceId', () => text(o.openedDeviceId));
+    wennDa(r, o, 'closedAt', () => text(o.closedAt));
+    wennDa(r, o, 'closedBy', () => akteur(unter(ort, 'closedBy'), o.closedBy));
+    wennDa(r, o, 'closedDeviceId', () => text(o.closedDeviceId));
+    wennDa(r, o, 'openingFloatCents', () => ganzzahlOderNull(ort, o, 'openingFloatCents'));
+    wennDa(r, o, 'openingDenominations', () => stueckelung(ort, o, 'openingDenominations'));
+    wennDa(r, o, 'openingFloatTakenOver', () => wahr(ort, o, 'openingFloatTakenOver'));
+    wennDa(r, o, 'comment', () => text(o.comment));
+    wennDa(r, o, 'blind', () => wahrOderNull(ort, o, 'blind'));
+    wennDa(r, o, 'countedCents', () => ganzzahlOderNull(ort, o, 'countedCents'));
+    wennDa(r, o, 'suggestedFloatCents', () => ganzzahlOderNull(ort, o, 'suggestedFloatCents'));
+    wennDa(r, o, 'runningTotals', () => laufstand(unter(ort, 'runningTotals'), o.runningTotals));
+    wennDa(r, o, 'expectedCents', () => ganzzahlOderNull(ort, o, 'expectedCents'));
+    wennDa(r, o, 'differenceCents', () => ganzzahlOderNull(ort, o, 'differenceCents'));
+    wennDa(r, o, 'reconciliation', () => abgleich(unter(ort, 'reconciliation'), o.reconciliation));
+    // Nur wenn beim Abschluss Geld entnommen oder eingelegt wurde.
+    wennWert(r, o, 'afterCount', () => nachZaehlung(unter(ort, 'afterCount'), o.afterCount));
+    wennWert(r, o, 'leftInDrawerCents', () => ganzzahl(ort, o, 'leftInDrawerCents'));
+    return raus;
+}
+function schichtOderNull(ort, w) {
+    return w === null ? null : schicht(ort, w);
+}
+function anspruch(ort, w) {
+    const o = pflichtObjekt(ort, w);
+    return { registerUserId: kennung(ort, o, 'registerUserId'), name: text(o.name), cents: ganzzahl(ort, o, 'cents') };
+}
+function oeffnung(ort, w) {
+    const o = pflichtObjekt(ort, w);
+    const von = objekt(o.by);
+    return {
+        at: text(o.at),
+        deviceTime: text(o.deviceTime),
+        reason: kennung(ort, o, 'reason'),
+        by: von ? { name: text(von.name) } : null,
+        ok: wahr(ort, o, 'ok'),
+    };
+}
+function ladeStand(ort, w) {
+    const o = pflichtObjekt(ort, w);
+    const lade = pflichtObjekt(unter(ort, 'drawer'), o.drawer);
+    const ladeOrt = unter(ort, 'drawer');
+    const rechte = pflichtObjekt(unter(ort, 'rights'), o.rights);
+    const rechteOrt = unter(ort, 'rights');
+    const raus = {
+        drawer: {
+            id: kennung(ladeOrt, lade, 'id'),
+            name: text(lade.name),
+            shiftMode: wahr(ladeOrt, lade, 'shiftMode'),
+            cashregisterId: text(lade.cashregisterId),
+        },
+        rights: {
+            shift: wahr(rechteOrt, rechte, 'shift'),
+            cashMove: wahr(rechteOrt, rechte, 'cashMove'),
+            cashView: wahr(rechteOrt, rechte, 'cashView'),
+            drawer: wahr(rechteOrt, rechte, 'drawer'),
+        },
+        tipClaims: liste(ort, o, 'tipClaims', anspruch),
+        tips: liste(ort, o, 'tips', trinkgeldMitOffen),
+    };
+    const r = raus;
+    wennDa(r, o, 'shift', () => schichtOderNull(unter(ort, 'shift'), o.shift));
+    wennDa(r, o, 'longOpenWarning', () => wahr(ort, o, 'longOpenWarning'));
+    wennDa(r, o, 'suggestedFloatCents', () => ganzzahlOderNull(ort, o, 'suggestedFloatCents'));
+    wennDa(r, o, 'expectedCents', () => ganzzahlOderNull(ort, o, 'expectedCents'));
+    wennDa(r, o, 'recentOpenings', () => liste(ort, o, 'recentOpenings', oeffnung));
+    wennWert(r, o, 'suggestedFromShiftNumber', () => ganzzahl(ort, o, 'suggestedFromShiftNumber'));
+    // Wechselgeld der Lade: nur wenn eingestellt.
+    wennWert(raus.drawer, lade, 'changeFloatCents', () => ganzzahl(ladeOrt, lade, 'changeFloatCents'));
+    return raus;
+}
+function bewegung(ort, w) {
+    const o = pflichtObjekt(ort, w);
+    const empfaenger = objekt(o.recipient);
+    const paar = objekt(o.counterpart);
+    return {
+        id: kennung(ort, o, 'id'),
+        number: ganzzahl(ort, o, 'number'),
+        shiftId: text(o.shiftId),
+        type: kennung(ort, o, 'type'),
+        amountCents: ganzzahl(ort, o, 'amountCents'),
+        location: text(o.location),
+        note: text(o.note),
+        by: akteur(unter(ort, 'by'), o.by),
+        at: text(o.at),
+        recipient: empfaenger ? { registerUserId: text(empfaenger.registerUserId), name: text(empfaenger.name) } : null,
+        counterpart: paar ? { drawerId: text(paar.drawerId), movementId: text(paar.movementId) } : null,
+    };
+}
+function bonKopf(ort, o) {
+    const art = o.kind;
+    if (typeof art !== 'string' || !schicht_typen_js_1.SHIFT_RECEIPT_KINDS.includes(art))
+        throw fehler(ort, `${ort.pfad}.kind ist unbekannt`);
+    const betrieb = objekt(o.business) ?? {};
+    const kasse = objekt(o.cashregister) ?? {};
+    const lade = objekt(o.drawer) ?? {};
+    return {
+        kind: art,
+        blind: wahr(ort, o, 'blind'),
+        business: { name: text(betrieb.name) },
+        cashregister: { id: text(kasse.id), name: text(kasse.name) },
+        drawer: { name: text(lade.name) },
+    };
+}
+/** Bon-Daten eines Z- oder X-Bons; eine andere Art ist ein Fehler. */
+function schichtBon(ort, w) {
+    const o = pflichtObjekt(ort, w);
+    const kopf = bonKopf(ort, o);
+    if (kopf.kind === 'cash_movement')
+        throw fehler(ort, `${ort.pfad}.kind ist cash_movement, erwartet Z- oder X-Bon`);
+    const s = pflichtObjekt(unter(ort, 'shift'), o.shift);
+    const sOrt = unter(ort, 'shift');
+    const raus = {
+        ...kopf,
+        kind: kopf.kind,
+        shift: {
+            number: ganzzahl(sOrt, s, 'number'),
+            openedAt: text(s.openedAt),
+            closedAt: text(s.closedAt),
+            openedByName: text(s.openedByName),
+            closedByName: text(s.closedByName),
+        },
+        openingFloatCents: ganzzahlOderNull(ort, o, 'openingFloatCents'),
+        openingFloatTakenOver: wahr(ort, o, 'openingFloatTakenOver'),
+        openingDenominations: stueckelung(ort, o, 'openingDenominations'),
+        cashSalesCents: ganzzahlOderNull(ort, o, 'cashSalesCents'),
+        cashCancellationsCents: ganzzahlOderNull(ort, o, 'cashCancellationsCents'),
+        receiptCount: ganzzahl(ort, o, 'receiptCount'),
+        cancellationCount: ganzzahl(ort, o, 'cancellationCount'),
+        nonCashByMethod: liste(ort, o, 'nonCashByMethod', unbar),
+        movements: liste(ort, o, 'movements', (mOrt, mw) => {
+            const m = pflichtObjekt(mOrt, mw);
+            return {
+                number: ganzzahl(mOrt, m, 'number'),
+                type: kennung(mOrt, m, 'type'),
+                amountCents: ganzzahl(mOrt, m, 'amountCents'),
+                note: text(m.note),
+                byName: text(m.byName),
+                at: text(m.at),
+            };
+        }),
+        tips: liste(ort, o, 'tips', trinkgeldMitOffen),
+        expectedCents: ganzzahlOderNull(ort, o, 'expectedCents'),
+        countedCents: ganzzahlOderNull(ort, o, 'countedCents'),
+        countedDenominations: stueckelung(ort, o, 'countedDenominations'),
+        differenceCents: ganzzahlOderNull(ort, o, 'differenceCents'),
+        comment: text(o.comment),
+        openingsWithoutSale: ganzzahl(ort, o, 'openingsWithoutSale'),
+    };
+    // Nur wenn beim Abschluss Geld entnommen oder eingelegt wurde; „Bleibt“ blind `null`.
+    const r = raus;
+    wennWert(r, o, 'afterCount', () => nachZaehlung(unter(ort, 'afterCount'), o.afterCount));
+    wennDa(r, o, 'leftInDrawerCents', () => ganzzahlOderNull(ort, o, 'leftInDrawerCents'));
+    return raus;
+}
+/** Bon-Daten einer Kassenbewegung; eine andere Art ist ein Fehler. */
+function bewegungsBon(ort, w) {
+    const o = pflichtObjekt(ort, w);
+    const kopf = bonKopf(ort, o);
+    if (kopf.kind !== 'cash_movement')
+        throw fehler(ort, `${ort.pfad}.kind ist ${kopf.kind}, erwartet cash_movement`);
+    const s = objekt(o.shift);
+    const m = pflichtObjekt(unter(ort, 'movement'), o.movement);
+    const mOrt = unter(ort, 'movement');
+    return {
+        ...kopf,
+        kind: 'cash_movement',
+        shift: s ? { number: ganzzahl(unter(ort, 'shift'), s, 'number') } : null,
+        movement: {
+            number: ganzzahl(mOrt, m, 'number'),
+            type: kennung(mOrt, m, 'type'),
+            amountCents: ganzzahl(mOrt, m, 'amountCents'),
+            note: text(m.note),
+            location: text(m.location),
+            recipientName: text(m.recipientName),
+            targetDrawerName: text(m.targetDrawerName),
+            byName: text(m.byName),
+            at: text(m.at),
+        },
+    };
+}
+function abschluss(ort, w) {
+    const o = pflichtObjekt(ort, w);
+    if (o.status === 'recount')
+        return { status: 'recount' };
+    if (o.status === 'ready')
+        return { status: 'ready' };
+    if (o.status !== 'closed')
+        throw fehler(ort, `${ort.pfad || 'data'}.status ist unbekannt`);
+    const raus = {
+        status: 'closed',
+        shift: schicht(unter(ort, 'shift'), o.shift),
+        receipt: schichtBon(unter(ort, 'receipt'), o.receipt),
+        lastShiftOfRegister: wahr(ort, o, 'lastShiftOfRegister'),
+    };
+    // Bon „Kassenbewegung“ der Entnahme bzw. Einlage, nur wenn Geld bewegt wurde.
+    wennWert(raus, o, 'afterCountReceipt', () => bewegungsBon(unter(ort, 'afterCountReceipt'), o.afterCountReceipt));
+    return raus;
+}
+function geoeffnet(ort, w) {
+    const o = pflichtObjekt(ort, w);
+    const raus = { shift: schicht(unter(ort, 'shift'), o.shift) };
+    wennDa(raus, o, 'handoverDifferenceCents', () => ganzzahlOderNull(ort, o, 'handoverDifferenceCents'));
+    return raus;
+}
+function gebucht(ort, w) {
+    const o = pflichtObjekt(ort, w);
+    return { movement: bewegung(unter(ort, 'movement'), o.movement), receipt: bewegungsBon(unter(ort, 'receipt'), o.receipt) };
+}
+function gemeldet(ort, w) {
+    const o = pflichtObjekt(ort, w);
+    return { accepted: ganzzahl(ort, o, 'accepted'), duplicates: ganzzahl(ort, o, 'duplicates'), drawerId: text(o.drawerId) };
+}
+function bericht(ort, w) {
+    const o = pflichtObjekt(ort, w);
+    return {
+        shift: schicht(unter(ort, 'shift'), o.shift),
+        movements: liste(ort, o, 'movements', bewegung),
+        receipt: schichtBon(unter(ort, 'receipt'), o.receipt),
+    };
+}