@kreiseck/kasseneck-api 1.3.0 → 1.5.0

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

@@ -0,0 +1,21 @@
+/**
+ * `@kreiseck/kasseneck-api/inventory` – die Lager-API: Artikel, Standorte,
+ * Bestand und Lagerprotokoll lesen, Konto-Webhooks verwalten und eingehende
+ * Zustellungen pruefen (Backend Stufe 5a); Artikel anlegen und aendern,
+ * Bestand buchen und Ware reservieren (Stufe 5b, seit 1.5.0).
+ *
+ * Ein eigener Unterpfad wie `invoice`: der `api_key` eines Kontos gehoert auf
+ * einen **Server** (etwa das Backend eines Online-Shops) und soll nicht
+ * versehentlich in ein Browser-Buendel wandern.
+ *
+ * Mengen in Tausendstel der Basiseinheit, Geld in Cent, Einkaufspreise in
+ * Mikro-Euro; alles Ganzzahlen.
+ */
+export { createInventoryClient, type InventoryClient, type InventoryClientOptions } from './api.js';
+export { inventoryKeyAuth, type InventoryKeyAuthOptions } from './auth.js';
+export { isInventoryError, isInventoryErrorCode, inventoryErrorCode, inventoryFieldErrors, inventoryRetryAfterSec, inventoryShortfalls, isInventoryWarningCode, type InventoryApiErrorCode, type InventoryFieldError, } from './fehler.js';
+export { createWebhook, deleteWebhook, getArticle, getStock, iterateArticles, iterateStock, iterateStockMovements, listArticles, listLocations, listStock, listStockMovements, listWebhookDeliveries, listWebhooks, lookupArticleByCode, rotateWebhookSecret, sendWebhookTest, updateWebhook, } from './endpunkte.js';
+export { changeStockCondition, createArticle, createReservation, deactivateArticle, extendReservation, getReservation, iterateReservations, listReservations, previewGoodsReceipt, receiveGoods, recordStockLoss, releaseReservation, reverseStockMovement, transferStock, updateArticle, } from './schreiben.js';
+export { verifyInventoryWebhookSignature, parseInventoryWebhookEvent, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_EVENT_HEADER, WEBHOOK_DELIVERY_HEADER, WEBHOOK_TOLERANCE_SEC, type VerifyInventoryWebhookOptions, } from './webhook.js';
+export type { Article, ArticleInput, ArticleListQuery, ArticleLookup, ArticlePage, ChangeStockConditionRequest, CreateArticleRequest, CreateInventoryWebhookOptions, CreateReservationRequest, DeactivateArticleRequest, ExtendReservationRequest, GoodsReceiptItem, GoodsReceiptPreview, GoodsReceiptPreviewLine, GoodsReceiptPreviewRequest, InventoryShortfall, InventoryWarning, InventoryWebhook, InventoryWebhookDelivery, InventoryWebhookEnvelope, InventoryWebhookEvent, InventoryWebhookList, InventoryWebhookPatch, InventoryWebhookTestDelivery, InventoryWebhookTestResult, InventoryWebhookWithSecret, LandedCost, Location, LocationAddress, ReceiveGoodsRequest, RecordStockLossRequest, ReleaseReservationItem, ReleaseReservationRequest, Reservation, ReservationItem, ReservationItemInput, ReservationListQuery, ReservationPage, ReverseStockMovementRequest, StockBelowMinimumEventData, StockChangedEventData, StockItem, StockLevel, StockListQuery, StockMovement, StockMovementLot, StockMovementPage, StockMovementQuery, StockMovementSourceRef, StockOperation, StockPage, StockResult, StockValue, TransferStockRequest, UpdateArticleRequest, } from './typen.js';
+export { INVENTORY_ENDPOINTS, INVENTORY_ERROR_CODES, INVENTORY_REQUEST_ERROR_CODES, INVENTORY_WEBHOOK_EVENTS, INVENTORY_WEBHOOK_ENVELOPE_FIELDS, INVENTORY_WEBHOOK_LIMIT, INVENTORY_LIST_LIMIT_MAX, LOCATION_TYPES, STOCK_MOVEMENT_TYPES, STOCK_MOVEMENT_SOURCES, STOCK_CONDITIONS, STOCK_CHANGE_CAUSES, WEBHOOK_DELIVERY_STATUSES, INVENTORY_WARNING_CODES, STOCK_KINDS, STOCK_LOSS_REASONS, WITHDRAWAL_TYPES, LANDED_COST_TYPES, LANDED_COST_ALLOCATIONS, RESERVATION_STATUSES, INVENTORY_IDEMPOTENCY_KEY_MAX, RESERVATION_MINUTES_MIN, RESERVATION_MINUTES_MAX, type InventoryEndpoint, type InventoryErrorCode, type InventoryRequestErrorCode, type InventoryWebhookEventType, type LocationType, type StockMovementType, type StockMovementSource, type StockCondition, type StockChangeCause, type WebhookDeliveryStatus, type InventoryWarningCode, type StockKind, type StockLossReason, type WithdrawalType, type LandedCostType, type LandedCostAllocation, type ReservationStatus, } from './vertrag.js';

package/dist/cjs/inventory/index.js

@@ -0,0 +1,94 @@
+"use strict";
+/**
+ * `@kreiseck/kasseneck-api/inventory` – die Lager-API: Artikel, Standorte,
+ * Bestand und Lagerprotokoll lesen, Konto-Webhooks verwalten und eingehende
+ * Zustellungen pruefen (Backend Stufe 5a); Artikel anlegen und aendern,
+ * Bestand buchen und Ware reservieren (Stufe 5b, seit 1.5.0).
+ *
+ * Ein eigener Unterpfad wie `invoice`: der `api_key` eines Kontos gehoert auf
+ * einen **Server** (etwa das Backend eines Online-Shops) und soll nicht
+ * versehentlich in ein Browser-Buendel wandern.
+ *
+ * Mengen in Tausendstel der Basiseinheit, Geld in Cent, Einkaufspreise in
+ * Mikro-Euro; alles Ganzzahlen.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INVENTORY_REQUEST_ERROR_CODES = exports.INVENTORY_ERROR_CODES = exports.INVENTORY_ENDPOINTS = exports.WEBHOOK_TOLERANCE_SEC = exports.WEBHOOK_DELIVERY_HEADER = exports.WEBHOOK_EVENT_HEADER = exports.WEBHOOK_SIGNATURE_HEADER = exports.parseInventoryWebhookEvent = exports.verifyInventoryWebhookSignature = exports.updateArticle = exports.transferStock = exports.reverseStockMovement = exports.releaseReservation = exports.recordStockLoss = exports.receiveGoods = exports.previewGoodsReceipt = exports.listReservations = exports.iterateReservations = exports.getReservation = exports.extendReservation = exports.deactivateArticle = exports.createReservation = exports.createArticle = exports.changeStockCondition = exports.updateWebhook = exports.sendWebhookTest = exports.rotateWebhookSecret = exports.lookupArticleByCode = exports.listWebhooks = exports.listWebhookDeliveries = exports.listStockMovements = exports.listStock = exports.listLocations = exports.listArticles = exports.iterateStockMovements = exports.iterateStock = exports.iterateArticles = exports.getStock = exports.getArticle = exports.deleteWebhook = exports.createWebhook = exports.isInventoryWarningCode = exports.inventoryShortfalls = exports.inventoryRetryAfterSec = exports.inventoryFieldErrors = exports.inventoryErrorCode = exports.isInventoryErrorCode = exports.isInventoryError = exports.inventoryKeyAuth = exports.createInventoryClient = void 0;
+exports.RESERVATION_MINUTES_MAX = exports.RESERVATION_MINUTES_MIN = exports.INVENTORY_IDEMPOTENCY_KEY_MAX = exports.RESERVATION_STATUSES = exports.LANDED_COST_ALLOCATIONS = exports.LANDED_COST_TYPES = exports.WITHDRAWAL_TYPES = exports.STOCK_LOSS_REASONS = exports.STOCK_KINDS = exports.INVENTORY_WARNING_CODES = exports.WEBHOOK_DELIVERY_STATUSES = exports.STOCK_CHANGE_CAUSES = exports.STOCK_CONDITIONS = exports.STOCK_MOVEMENT_SOURCES = exports.STOCK_MOVEMENT_TYPES = exports.LOCATION_TYPES = exports.INVENTORY_LIST_LIMIT_MAX = exports.INVENTORY_WEBHOOK_LIMIT = exports.INVENTORY_WEBHOOK_ENVELOPE_FIELDS = exports.INVENTORY_WEBHOOK_EVENTS = void 0;
+var api_js_1 = require("./api.js");
+Object.defineProperty(exports, "createInventoryClient", { enumerable: true, get: function () { return api_js_1.createInventoryClient; } });
+var auth_js_1 = require("./auth.js");
+Object.defineProperty(exports, "inventoryKeyAuth", { enumerable: true, get: function () { return auth_js_1.inventoryKeyAuth; } });
+var fehler_js_1 = require("./fehler.js");
+Object.defineProperty(exports, "isInventoryError", { enumerable: true, get: function () { return fehler_js_1.isInventoryError; } });
+Object.defineProperty(exports, "isInventoryErrorCode", { enumerable: true, get: function () { return fehler_js_1.isInventoryErrorCode; } });
+Object.defineProperty(exports, "inventoryErrorCode", { enumerable: true, get: function () { return fehler_js_1.inventoryErrorCode; } });
+Object.defineProperty(exports, "inventoryFieldErrors", { enumerable: true, get: function () { return fehler_js_1.inventoryFieldErrors; } });
+Object.defineProperty(exports, "inventoryRetryAfterSec", { enumerable: true, get: function () { return fehler_js_1.inventoryRetryAfterSec; } });
+Object.defineProperty(exports, "inventoryShortfalls", { enumerable: true, get: function () { return fehler_js_1.inventoryShortfalls; } });
+Object.defineProperty(exports, "isInventoryWarningCode", { enumerable: true, get: function () { return fehler_js_1.isInventoryWarningCode; } });
+var endpunkte_js_1 = require("./endpunkte.js");
+Object.defineProperty(exports, "createWebhook", { enumerable: true, get: function () { return endpunkte_js_1.createWebhook; } });
+Object.defineProperty(exports, "deleteWebhook", { enumerable: true, get: function () { return endpunkte_js_1.deleteWebhook; } });
+Object.defineProperty(exports, "getArticle", { enumerable: true, get: function () { return endpunkte_js_1.getArticle; } });
+Object.defineProperty(exports, "getStock", { enumerable: true, get: function () { return endpunkte_js_1.getStock; } });
+Object.defineProperty(exports, "iterateArticles", { enumerable: true, get: function () { return endpunkte_js_1.iterateArticles; } });
+Object.defineProperty(exports, "iterateStock", { enumerable: true, get: function () { return endpunkte_js_1.iterateStock; } });
+Object.defineProperty(exports, "iterateStockMovements", { enumerable: true, get: function () { return endpunkte_js_1.iterateStockMovements; } });
+Object.defineProperty(exports, "listArticles", { enumerable: true, get: function () { return endpunkte_js_1.listArticles; } });
+Object.defineProperty(exports, "listLocations", { enumerable: true, get: function () { return endpunkte_js_1.listLocations; } });
+Object.defineProperty(exports, "listStock", { enumerable: true, get: function () { return endpunkte_js_1.listStock; } });
+Object.defineProperty(exports, "listStockMovements", { enumerable: true, get: function () { return endpunkte_js_1.listStockMovements; } });
+Object.defineProperty(exports, "listWebhookDeliveries", { enumerable: true, get: function () { return endpunkte_js_1.listWebhookDeliveries; } });
+Object.defineProperty(exports, "listWebhooks", { enumerable: true, get: function () { return endpunkte_js_1.listWebhooks; } });
+Object.defineProperty(exports, "lookupArticleByCode", { enumerable: true, get: function () { return endpunkte_js_1.lookupArticleByCode; } });
+Object.defineProperty(exports, "rotateWebhookSecret", { enumerable: true, get: function () { return endpunkte_js_1.rotateWebhookSecret; } });
+Object.defineProperty(exports, "sendWebhookTest", { enumerable: true, get: function () { return endpunkte_js_1.sendWebhookTest; } });
+Object.defineProperty(exports, "updateWebhook", { enumerable: true, get: function () { return endpunkte_js_1.updateWebhook; } });
+var schreiben_js_1 = require("./schreiben.js");
+Object.defineProperty(exports, "changeStockCondition", { enumerable: true, get: function () { return schreiben_js_1.changeStockCondition; } });
+Object.defineProperty(exports, "createArticle", { enumerable: true, get: function () { return schreiben_js_1.createArticle; } });
+Object.defineProperty(exports, "createReservation", { enumerable: true, get: function () { return schreiben_js_1.createReservation; } });
+Object.defineProperty(exports, "deactivateArticle", { enumerable: true, get: function () { return schreiben_js_1.deactivateArticle; } });
+Object.defineProperty(exports, "extendReservation", { enumerable: true, get: function () { return schreiben_js_1.extendReservation; } });
+Object.defineProperty(exports, "getReservation", { enumerable: true, get: function () { return schreiben_js_1.getReservation; } });
+Object.defineProperty(exports, "iterateReservations", { enumerable: true, get: function () { return schreiben_js_1.iterateReservations; } });
+Object.defineProperty(exports, "listReservations", { enumerable: true, get: function () { return schreiben_js_1.listReservations; } });
+Object.defineProperty(exports, "previewGoodsReceipt", { enumerable: true, get: function () { return schreiben_js_1.previewGoodsReceipt; } });
+Object.defineProperty(exports, "receiveGoods", { enumerable: true, get: function () { return schreiben_js_1.receiveGoods; } });
+Object.defineProperty(exports, "recordStockLoss", { enumerable: true, get: function () { return schreiben_js_1.recordStockLoss; } });
+Object.defineProperty(exports, "releaseReservation", { enumerable: true, get: function () { return schreiben_js_1.releaseReservation; } });
+Object.defineProperty(exports, "reverseStockMovement", { enumerable: true, get: function () { return schreiben_js_1.reverseStockMovement; } });
+Object.defineProperty(exports, "transferStock", { enumerable: true, get: function () { return schreiben_js_1.transferStock; } });
+Object.defineProperty(exports, "updateArticle", { enumerable: true, get: function () { return schreiben_js_1.updateArticle; } });
+var webhook_js_1 = require("./webhook.js");
+Object.defineProperty(exports, "verifyInventoryWebhookSignature", { enumerable: true, get: function () { return webhook_js_1.verifyInventoryWebhookSignature; } });
+Object.defineProperty(exports, "parseInventoryWebhookEvent", { enumerable: true, get: function () { return webhook_js_1.parseInventoryWebhookEvent; } });
+Object.defineProperty(exports, "WEBHOOK_SIGNATURE_HEADER", { enumerable: true, get: function () { return webhook_js_1.WEBHOOK_SIGNATURE_HEADER; } });
+Object.defineProperty(exports, "WEBHOOK_EVENT_HEADER", { enumerable: true, get: function () { return webhook_js_1.WEBHOOK_EVENT_HEADER; } });
+Object.defineProperty(exports, "WEBHOOK_DELIVERY_HEADER", { enumerable: true, get: function () { return webhook_js_1.WEBHOOK_DELIVERY_HEADER; } });
+Object.defineProperty(exports, "WEBHOOK_TOLERANCE_SEC", { enumerable: true, get: function () { return webhook_js_1.WEBHOOK_TOLERANCE_SEC; } });
+var vertrag_js_1 = require("./vertrag.js");
+Object.defineProperty(exports, "INVENTORY_ENDPOINTS", { enumerable: true, get: function () { return vertrag_js_1.INVENTORY_ENDPOINTS; } });
+Object.defineProperty(exports, "INVENTORY_ERROR_CODES", { enumerable: true, get: function () { return vertrag_js_1.INVENTORY_ERROR_CODES; } });
+Object.defineProperty(exports, "INVENTORY_REQUEST_ERROR_CODES", { enumerable: true, get: function () { return vertrag_js_1.INVENTORY_REQUEST_ERROR_CODES; } });
+Object.defineProperty(exports, "INVENTORY_WEBHOOK_EVENTS", { enumerable: true, get: function () { return vertrag_js_1.INVENTORY_WEBHOOK_EVENTS; } });
+Object.defineProperty(exports, "INVENTORY_WEBHOOK_ENVELOPE_FIELDS", { enumerable: true, get: function () { return vertrag_js_1.INVENTORY_WEBHOOK_ENVELOPE_FIELDS; } });
+Object.defineProperty(exports, "INVENTORY_WEBHOOK_LIMIT", { enumerable: true, get: function () { return vertrag_js_1.INVENTORY_WEBHOOK_LIMIT; } });
+Object.defineProperty(exports, "INVENTORY_LIST_LIMIT_MAX", { enumerable: true, get: function () { return vertrag_js_1.INVENTORY_LIST_LIMIT_MAX; } });
+Object.defineProperty(exports, "LOCATION_TYPES", { enumerable: true, get: function () { return vertrag_js_1.LOCATION_TYPES; } });
+Object.defineProperty(exports, "STOCK_MOVEMENT_TYPES", { enumerable: true, get: function () { return vertrag_js_1.STOCK_MOVEMENT_TYPES; } });
+Object.defineProperty(exports, "STOCK_MOVEMENT_SOURCES", { enumerable: true, get: function () { return vertrag_js_1.STOCK_MOVEMENT_SOURCES; } });
+Object.defineProperty(exports, "STOCK_CONDITIONS", { enumerable: true, get: function () { return vertrag_js_1.STOCK_CONDITIONS; } });
+Object.defineProperty(exports, "STOCK_CHANGE_CAUSES", { enumerable: true, get: function () { return vertrag_js_1.STOCK_CHANGE_CAUSES; } });
+Object.defineProperty(exports, "WEBHOOK_DELIVERY_STATUSES", { enumerable: true, get: function () { return vertrag_js_1.WEBHOOK_DELIVERY_STATUSES; } });
+Object.defineProperty(exports, "INVENTORY_WARNING_CODES", { enumerable: true, get: function () { return vertrag_js_1.INVENTORY_WARNING_CODES; } });
+Object.defineProperty(exports, "STOCK_KINDS", { enumerable: true, get: function () { return vertrag_js_1.STOCK_KINDS; } });
+Object.defineProperty(exports, "STOCK_LOSS_REASONS", { enumerable: true, get: function () { return vertrag_js_1.STOCK_LOSS_REASONS; } });
+Object.defineProperty(exports, "WITHDRAWAL_TYPES", { enumerable: true, get: function () { return vertrag_js_1.WITHDRAWAL_TYPES; } });
+Object.defineProperty(exports, "LANDED_COST_TYPES", { enumerable: true, get: function () { return vertrag_js_1.LANDED_COST_TYPES; } });
+Object.defineProperty(exports, "LANDED_COST_ALLOCATIONS", { enumerable: true, get: function () { return vertrag_js_1.LANDED_COST_ALLOCATIONS; } });
+Object.defineProperty(exports, "RESERVATION_STATUSES", { enumerable: true, get: function () { return vertrag_js_1.RESERVATION_STATUSES; } });
+Object.defineProperty(exports, "INVENTORY_IDEMPOTENCY_KEY_MAX", { enumerable: true, get: function () { return vertrag_js_1.INVENTORY_IDEMPOTENCY_KEY_MAX; } });
+Object.defineProperty(exports, "RESERVATION_MINUTES_MIN", { enumerable: true, get: function () { return vertrag_js_1.RESERVATION_MINUTES_MIN; } });
+Object.defineProperty(exports, "RESERVATION_MINUTES_MAX", { enumerable: true, get: function () { return vertrag_js_1.RESERVATION_MINUTES_MAX; } });

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

@@ -0,0 +1,45 @@
+/**
+ * Leser der Lager-Antworten: aus dem Draht `/v3` werden die Modelle in
+ * `typen.ts`. Paketintern, nicht Teil der Oberflaeche.
+ *
+ * Regel wie beim Lager an der Kasse (`pos/lager.ts`): eine Menge, ein Betrag
+ * oder eine Folgenummer ist eine Ganzzahl, sonst endet der Aufruf mit
+ * `KasseneckValidationError` (`scope: 'response'`). Ein Ersatzwert wie `0`
+ * waere eine falsche Aussage („kein Bestand“ statt „Antwort kaputt“). Texte
+ * sind nachsichtiger: ein fehlender oder fremder Wert wird `null`.
+ *
+ * Optionale Felder (Einkaufswerte, `externalIds` …) erscheinen im Modell nur,
+ * wenn der Server sie sendet: „fehlt“ heisst dort „kein Recht“, nicht „leer“.
+ */
+import { KasseneckValidationError } from '../client/errors.js';
+import type { Article, GoodsReceiptPreviewLine, InventoryShortfall, InventoryWebhook, InventoryWebhookDelivery, InventoryWebhookTestDelivery, Location, Reservation, StockBelowMinimumEventData, StockChangedEventData, StockLevel, StockMovement, StockOperation, StockValue } from './typen.js';
+type Roh = Record<string, unknown>;
+/** Ein Leser bekommt den Vorgang (fuer die Meldung) und den Pfad im Rumpf. */
+export interface Ort {
+    name: string;
+    pfad: string;
+}
+export declare function antwortfehler(name: string, grund: string): KasseneckValidationError;
+export declare function objekt(w: unknown): Roh | null;
+export declare function artikel(ort: Ort, w: unknown): Article;
+export declare function standort(ort: Ort, w: unknown): Location;
+export declare function bestand(ort: Ort, w: unknown): StockLevel;
+export declare function wert(ort: Ort, w: unknown): StockValue;
+export declare function bewegung(ort: Ort, w: unknown): StockMovement;
+export declare function webhook(ort: Ort, w: unknown): InventoryWebhook;
+export declare function zustellung(ort: Ort, w: unknown): InventoryWebhookDelivery;
+export declare function probeZustellung(ort: Ort, w: unknown, webhookId: string): InventoryWebhookTestDelivery;
+export declare function bestandGeaendert(ort: Ort, w: unknown): StockChangedEventData;
+export declare function unterMindestbestand(ort: Ort, w: unknown): StockBelowMinimumEventData;
+/** Antwort einer Buchung; ohne `operationId` ist nicht belegt, dass gebucht wurde. */
+export declare function vorgang(name: string, daten: unknown): StockOperation;
+/** Eine Zeile der Wareneingangs-Vorschau; Werte nur, wenn der Server sie sendet (Recht `costs`). */
+export declare function vorschauZeile(ort: Ort, w: unknown): GoodsReceiptPreviewLine;
+export declare function reservierung(ort: Ort, w: unknown): Reservation;
+/** Die fehlenden Positionen aus `insufficient_available` (`data.details[]`); ein kaputter Eintrag faellt weg. */
+export declare function fehlmengen(roh: unknown): InventoryShortfall[];
+/** Eine zugesagte Liste `data.<feld>`, Eintrag fuer Eintrag gelesen. */
+export declare function liste<T>(name: string, daten: unknown, feld: string, lesen: (ort: Ort, e: unknown) => T): T[];
+/** Der Cursor der naechsten Seite; `null` am Ende. Etwas anderes als Text oder `null` ist kaputt. */
+export declare function naechsterCursor(name: string, daten: unknown): string | null;
+export {};

package/dist/cjs/inventory/lesen.js

@@ -0,0 +1,424 @@
+"use strict";
+/**
+ * Leser der Lager-Antworten: aus dem Draht `/v3` werden die Modelle in
+ * `typen.ts`. Paketintern, nicht Teil der Oberflaeche.
+ *
+ * Regel wie beim Lager an der Kasse (`pos/lager.ts`): eine Menge, ein Betrag
+ * oder eine Folgenummer ist eine Ganzzahl, sonst endet der Aufruf mit
+ * `KasseneckValidationError` (`scope: 'response'`). Ein Ersatzwert wie `0`
+ * waere eine falsche Aussage („kein Bestand“ statt „Antwort kaputt“). Texte
+ * sind nachsichtiger: ein fehlender oder fremder Wert wird `null`.
+ *
+ * Optionale Felder (Einkaufswerte, `externalIds` …) erscheinen im Modell nur,
+ * wenn der Server sie sendet: „fehlt“ heisst dort „kein Recht“, nicht „leer“.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.antwortfehler = antwortfehler;
+exports.objekt = objekt;
+exports.artikel = artikel;
+exports.standort = standort;
+exports.bestand = bestand;
+exports.wert = wert;
+exports.bewegung = bewegung;
+exports.webhook = webhook;
+exports.zustellung = zustellung;
+exports.probeZustellung = probeZustellung;
+exports.bestandGeaendert = bestandGeaendert;
+exports.unterMindestbestand = unterMindestbestand;
+exports.vorgang = vorgang;
+exports.vorschauZeile = vorschauZeile;
+exports.reservierung = reservierung;
+exports.fehlmengen = fehlmengen;
+exports.liste = liste;
+exports.naechsterCursor = naechsterCursor;
+const errors_js_1 = require("../client/errors.js");
+const vertrag_js_1 = require("./vertrag.js");
+const hat = (o, k) => Object.prototype.hasOwnProperty.call(o, k);
+function antwortfehler(name, grund) {
+    return new errors_js_1.KasseneckValidationError(name, grund, 'response');
+}
+function objekt(w) {
+    return w !== null && typeof w === 'object' && !Array.isArray(w) ? w : null;
+}
+/** Ein Eintrag, der ein Objekt sein muss. */
+function eintrag(ort, w) {
+    const o = objekt(w);
+    if (!o)
+        throw antwortfehler(ort.name, `Antwort ist unbrauchbar (data.${ort.pfad} ist kein Objekt)`);
+    return o;
+}
+const text = (w) => (typeof w === 'string' ? w : null);
+/** Eine Kennung, die da sein muss; ohne sie ist der Eintrag nicht zuzuordnen. */
+function kennung(ort, feld, w) {
+    if (typeof w !== 'string' || w === '') {
+        throw antwortfehler(ort.name, `Antwort enthaelt keine Kennung (data.${ort.pfad}.${feld} fehlt)`);
+    }
+    return w;
+}
+/** Eine Ganzzahl, die da sein muss. */
+function ganzzahl(ort, feld, w) {
+    if (typeof w !== 'number' || !Number.isSafeInteger(w)) {
+        throw antwortfehler(ort.name, `Antwort enthaelt keine ganze Zahl (data.${ort.pfad}.${feld})`);
+    }
+    return w;
+}
+/** Eine Ganzzahl oder `null`; fehlt der Wert, gilt `null`. */
+function ganzzahlOderNull(ort, feld, w) {
+    if (w === undefined || w === null)
+        return null;
+    return ganzzahl(ort, feld, w);
+}
+/** Eine Textabbildung (`externalIds`, `metadata`, `variantAttributes`): nur Texteintraege. */
+function textAbbildung(w) {
+    const o = objekt(w);
+    if (!o)
+        return undefined;
+    const raus = {};
+    for (const [k, v] of Object.entries(o))
+        if (typeof v === 'string')
+            raus[k] = v;
+    return raus;
+}
+/**
+ * Mengen je Standort (`minStockByLocation`): jeder Wert eine Ganzzahl. Fehlt
+ * das Feld (Server vor Stufe 5b), gilt „keiner“ (`{}`).
+ */
+function mengenJeStandort(ort, feld, w) {
+    if (w === undefined || w === null)
+        return {};
+    const o = objekt(w);
+    if (!o)
+        throw antwortfehler(ort.name, `Antwort ist unbrauchbar (data.${ort.pfad}.${feld} ist kein Objekt)`);
+    const raus = {};
+    for (const [k, v] of Object.entries(o))
+        raus[k] = ganzzahl(ort, `${feld}.${k}`, v);
+    return raus;
+}
+/** Eine Liste von Kennungen (`movementIds`, `lotIds`); fehlt sie, ist sie leer. */
+function kennungsliste(ort, feld, w) {
+    if (w === undefined || w === null)
+        return [];
+    if (!Array.isArray(w) || !w.every((x) => typeof x === 'string')) {
+        throw antwortfehler(ort.name, `Antwort ist unbrauchbar (data.${ort.pfad}${ort.pfad ? '.' : ''}${feld} ist keine Liste von Kennungen)`);
+    }
+    return [...w];
+}
+// ---- Artikel ------------------------------------------------------------------
+function artikel(ort, w) {
+    const a = eintrag(ort, w);
+    let standorte = [];
+    if (a.stockLocationIds !== undefined && a.stockLocationIds !== null) {
+        if (!Array.isArray(a.stockLocationIds) || !a.stockLocationIds.every((s) => typeof s === 'string')) {
+            throw antwortfehler(ort.name, `Antwort ist unbrauchbar (data.${ort.pfad}.stockLocationIds ist keine Liste von Kennungen)`);
+        }
+        standorte = [...a.stockLocationIds];
+    }
+    const vatRate = a.vatRate;
+    if (vatRate !== undefined && vatRate !== null && (typeof vatRate !== 'number' || !Number.isFinite(vatRate))) {
+        throw antwortfehler(ort.name, `Antwort enthaelt keinen USt-Satz (data.${ort.pfad}.vatRate)`);
+    }
+    const raus = {
+        id: kennung(ort, 'id', a.id),
+        name: text(a.name),
+        description: text(a.description),
+        unitPriceCents: ganzzahlOderNull(ort, 'unitPriceCents', a.unitPriceCents),
+        vatRate: typeof vatRate === 'number' ? vatRate : null,
+        unit: text(a.unit),
+        number: text(a.number),
+        ean: text(a.ean),
+        internalCode: text(a.internalCode),
+        groupId: text(a.groupId),
+        revenueGroupId: text(a.revenueGroupId),
+        stockTracked: a.stockTracked === true,
+        stockKind: textOderNull(a.stockKind),
+        stockLocationIds: standorte,
+        minStock: ganzzahlOderNull(ort, 'minStock', a.minStock),
+        minStockByLocation: mengenJeStandort(ort, 'minStockByLocation', a.minStockByLocation),
+        active: a.active !== false,
+        createdAt: text(a.createdAt),
+        updatedAt: text(a.updatedAt),
+    };
+    for (const feld of ['externalIds', 'metadata', 'variantAttributes']) {
+        const abb = textAbbildung(a[feld]);
+        if (abb)
+            raus[feld] = abb;
+    }
+    if (typeof a.variantGroupId === 'string')
+        raus.variantGroupId = a.variantGroupId;
+    // Nur mit dem Recht `costs`; ohne fehlt das Feld ganz.
+    if (hat(a, 'purchasePriceMicros'))
+        raus.purchasePriceMicros = ganzzahlOderNull(ort, 'purchasePriceMicros', a.purchasePriceMicros);
+    return raus;
+}
+// ---- Standorte ------------------------------------------------------------------
+const TYPEN = new Set(vertrag_js_1.LOCATION_TYPES);
+const textOderNull = (w) => (typeof w === 'string' && w !== '' ? w : null);
+function standort(ort, w) {
+    const s = eintrag(ort, w);
+    const a = objekt(s.address);
+    const teile = a ? { street: textOderNull(a.street), zip: textOderNull(a.zip), city: textOderNull(a.city), country: textOderNull(a.country) } : null;
+    return {
+        id: kennung(ort, 'id', s.id),
+        name: typeof s.name === 'string' ? s.name : '',
+        type: typeof s.type === 'string' && TYPEN.has(s.type) ? s.type : null,
+        // Eine Adresse ohne einen einzigen Teil ist keine Adresse.
+        address: teile && Object.values(teile).some((t) => t !== null) ? teile : null,
+        licensePlate: textOderNull(s.licensePlate),
+        active: s.active !== false,
+        virtual: s.virtual === true,
+    };
+}
+// ---- Bestand ------------------------------------------------------------------
+function bestand(ort, w) {
+    const b = eintrag(ort, w);
+    return {
+        articleId: kennung(ort, 'articleId', b.articleId),
+        locationId: kennung(ort, 'locationId', b.locationId),
+        onHand: ganzzahl(ort, 'onHand', b.onHand),
+        reserved: ganzzahl(ort, 'reserved', b.reserved),
+        available: ganzzahl(ort, 'available', b.available),
+        defective: ganzzahl(ort, 'defective', b.defective),
+        sequence: ganzzahl(ort, 'sequence', b.sequence),
+        updatedAt: text(b.updatedAt),
+    };
+}
+function wert(ort, w) {
+    const v = eintrag(ort, w);
+    return {
+        articleId: kennung(ort, 'articleId', v.articleId),
+        stockValueCents: ganzzahl(ort, 'stockValueCents', v.stockValueCents),
+        averageCostMicros: ganzzahlOderNull(ort, 'averageCostMicros', v.averageCostMicros),
+    };
+}
+// ---- Bewegungen ------------------------------------------------------------------
+function los(ort, w) {
+    const l = eintrag(ort, w);
+    const raus = {
+        lotId: text(l.lotId),
+        quantity: ganzzahl(ort, 'quantity', l.quantity),
+        expiresOn: text(l.expiresOn),
+        batch: text(l.batch),
+        serialNumber: text(l.serialNumber),
+        receivedAt: text(l.receivedAt),
+    };
+    if (hat(l, 'valueCents'))
+        raus.valueCents = ganzzahlOderNull(ort, 'valueCents', l.valueCents);
+    return raus;
+}
+function bewegung(ort, w) {
+    const b = eintrag(ort, w);
+    const nachher = objekt(b.stockAfter);
+    const quelle = objekt(b.source);
+    const lose = b.lots === undefined || b.lots === null ? [] : b.lots;
+    if (!Array.isArray(lose))
+        throw antwortfehler(ort.name, `Antwort ist unbrauchbar (data.${ort.pfad}.lots ist keine Liste)`);
+    const nachherOrt = { name: ort.name, pfad: `${ort.pfad}.stockAfter` };
+    const raus = {
+        id: kennung(ort, 'id', b.id),
+        type: text(b.type),
+        articleId: text(b.articleId),
+        locationId: text(b.locationId),
+        condition: text(b.condition),
+        quantityDelta: ganzzahl(ort, 'quantityDelta', b.quantityDelta),
+        // Server vor Stufe 5b senden das Feld nicht: dort aenderte keine Bewegung `reserved`.
+        reservedDelta: b.reservedDelta === undefined ? 0 : ganzzahl(ort, 'reservedDelta', b.reservedDelta),
+        stockAfter: nachher
+            ? {
+                sellable: ganzzahl(nachherOrt, 'sellable', nachher.sellable),
+                defective: ganzzahl(nachherOrt, 'defective', nachher.defective),
+                reserved: ganzzahlOderNull(nachherOrt, 'reserved', nachher.reserved),
+            }
+            : null,
+        operationId: text(b.operationId),
+        source: quelle
+            ? {
+                type: text(quelle.type),
+                id: text(quelle.id),
+                register: text(quelle.register),
+                position: typeof quelle.position === 'number' && Number.isSafeInteger(quelle.position) ? quelle.position : null,
+            }
+            : null,
+        viennaDay: text(b.viennaDay),
+        time: text(b.time),
+        lots: lose.map((l, i) => los({ name: ort.name, pfad: `${ort.pfad}.lots[${i}]` }, l)),
+    };
+    if (hat(b, 'valueDeltaCents'))
+        raus.valueDeltaCents = ganzzahlOderNull(ort, 'valueDeltaCents', b.valueDeltaCents);
+    if (hat(b, 'consumedValueCents'))
+        raus.consumedValueCents = ganzzahlOderNull(ort, 'consumedValueCents', b.consumedValueCents);
+    return raus;
+}
+// ---- Webhooks ------------------------------------------------------------------
+const zahlOderNull = (w) => (typeof w === 'number' && Number.isFinite(w) ? w : null);
+function webhook(ort, w) {
+    const h = eintrag(ort, w);
+    const z = objekt(h.lastDelivery);
+    return {
+        id: kennung(ort, 'id', h.id),
+        url: typeof h.url === 'string' ? h.url : '',
+        events: Array.isArray(h.events) ? h.events.filter((e) => typeof e === 'string') : [],
+        active: h.active !== false,
+        description: text(h.description),
+        createdAt: text(h.createdAt),
+        lastDelivery: z ? { at: text(z.at), status: text(z.status), statusCode: zahlOderNull(z.statusCode) } : null,
+        consecutiveFailures: typeof h.consecutiveFailures === 'number' && Number.isSafeInteger(h.consecutiveFailures) ? h.consecutiveFailures : 0,
+    };
+}
+function zustellung(ort, w) {
+    const z = eintrag(ort, w);
+    return {
+        deliveryId: kennung(ort, 'deliveryId', z.deliveryId),
+        webhookId: text(z.webhookId),
+        event: text(z.event),
+        eventId: text(z.eventId),
+        status: text(z.status),
+        attempts: typeof z.attempts === 'number' && Number.isSafeInteger(z.attempts) ? z.attempts : 0,
+        statusCode: zahlOderNull(z.statusCode),
+        response: text(z.response),
+        error: text(z.error),
+        createdAt: text(z.createdAt),
+        lastAttemptAt: text(z.lastAttemptAt),
+        nextAttemptAt: text(z.nextAttemptAt),
+        test: z.test === true,
+    };
+}
+function probeZustellung(ort, w, webhookId) {
+    const z = eintrag(ort, w);
+    return {
+        deliveryId: kennung(ort, 'deliveryId', z.deliveryId),
+        webhookId: typeof z.webhookId === 'string' && z.webhookId ? z.webhookId : webhookId,
+        status: text(z.status),
+        statusCode: zahlOderNull(z.statusCode),
+    };
+}
+// ---- Ereignisse ------------------------------------------------------------------
+function bestandGeaendert(ort, w) {
+    const d = eintrag(ort, w);
+    const ursache = d.cause;
+    if (typeof ursache !== 'string' || ursache === '')
+        throw antwortfehler(ort.name, `Ereignis ohne Ursache (${ort.pfad}.cause)`);
+    return { ...bestand(ort, d), cause: ursache, movementId: textOderNull(d.movementId) };
+}
+function unterMindestbestand(ort, w) {
+    const d = eintrag(ort, w);
+    return {
+        articleId: kennung(ort, 'articleId', d.articleId),
+        locationId: kennung(ort, 'locationId', d.locationId),
+        available: ganzzahl(ort, 'available', d.available),
+        minStock: ganzzahl(ort, 'minStock', d.minStock),
+    };
+}
+// ---- Schreiben (Stufe 5b) ------------------------------------------------------------
+function warnung(ort, w) {
+    const h = eintrag(ort, w);
+    if (typeof h.code !== 'string' || h.code === '')
+        throw antwortfehler(ort.name, `Hinweis ohne Code (data.${ort.pfad}.code)`);
+    return {
+        code: h.code,
+        articleId: textOderNull(h.articleId),
+        locationId: textOderNull(h.locationId),
+        message: typeof h.message === 'string' ? h.message : '',
+    };
+}
+/** Antwort einer Buchung; ohne `operationId` ist nicht belegt, dass gebucht wurde. */
+function vorgang(name, daten) {
+    const d = objekt(daten);
+    if (!d)
+        throw antwortfehler(name, 'Antwort ist unbrauchbar (data ist kein Objekt)');
+    const ort = { name, pfad: '' };
+    if (typeof d.operationId !== 'string' || d.operationId === '') {
+        throw antwortfehler(name, 'Antwort enthaelt keine Kennung (data.operationId fehlt)');
+    }
+    const hinweise = d.warnings === undefined || d.warnings === null ? [] : d.warnings;
+    if (!Array.isArray(hinweise))
+        throw antwortfehler(name, 'Antwort ist unbrauchbar (data.warnings ist keine Liste)');
+    return {
+        operationId: d.operationId,
+        movementIds: kennungsliste(ort, 'movementIds', d.movementIds),
+        lotIds: kennungsliste(ort, 'lotIds', d.lotIds),
+        warnings: hinweise.map((h, i) => warnung({ name, pfad: `warnings[${i}]` }, h)),
+    };
+}
+/** Eine Zeile der Wareneingangs-Vorschau; Werte nur, wenn der Server sie sendet (Recht `costs`). */
+function vorschauZeile(ort, w) {
+    const z = eintrag(ort, w);
+    const serien = z.serialNumbers === undefined || z.serialNumbers === null ? [] : z.serialNumbers;
+    if (!Array.isArray(serien) || !serien.every((x) => typeof x === 'string')) {
+        throw antwortfehler(ort.name, `Antwort ist unbrauchbar (data.${ort.pfad}.serialNumbers ist keine Liste)`);
+    }
+    const raus = {
+        articleId: kennung(ort, 'articleId', z.articleId),
+        quantity: ganzzahl(ort, 'quantity', z.quantity),
+        expiresOn: textOderNull(z.expiresOn),
+        batch: textOderNull(z.batch),
+        serialNumbers: [...serien],
+        priceFromArticle: z.priceFromArticle === true,
+    };
+    for (const feld of ['baseCents', 'landedCostCents', 'valueCents', 'unitCostMicros']) {
+        if (hat(z, feld))
+            raus[feld] = ganzzahlOderNull(ort, feld, z[feld]);
+    }
+    return raus;
+}
+function reservierungsPosition(ort, w) {
+    const p = eintrag(ort, w);
+    return {
+        articleId: kennung(ort, 'articleId', p.articleId),
+        locationId: kennung(ort, 'locationId', p.locationId),
+        quantity: ganzzahl(ort, 'quantity', p.quantity),
+        redeemed: ganzzahl(ort, 'redeemed', p.redeemed),
+        released: ganzzahl(ort, 'released', p.released),
+    };
+}
+function reservierung(ort, w) {
+    const r = eintrag(ort, w);
+    if (!Array.isArray(r.items))
+        throw antwortfehler(ort.name, `Antwort ist unbrauchbar (data.${ort.pfad}.items ist keine Liste)`);
+    return {
+        id: kennung(ort, 'id', r.id),
+        status: textOderNull(r.status),
+        reference: text(r.reference),
+        items: r.items.map((p, i) => reservierungsPosition({ name: ort.name, pfad: `${ort.pfad}.items[${i}]` }, p)),
+        expiresAt: text(r.expiresAt),
+        createdAt: text(r.createdAt),
+    };
+}
+/** Die fehlenden Positionen aus `insufficient_available` (`data.details[]`); ein kaputter Eintrag faellt weg. */
+function fehlmengen(roh) {
+    if (!Array.isArray(roh))
+        return [];
+    const raus = [];
+    for (const e of roh) {
+        const o = objekt(e);
+        if (!o)
+            continue;
+        const { articleId, locationId, requested, available } = o;
+        if (typeof articleId !== 'string' || typeof locationId !== 'string')
+            continue;
+        if (!Number.isSafeInteger(requested) || !Number.isSafeInteger(available))
+            continue;
+        raus.push({ articleId, locationId, requested: requested, available: available });
+    }
+    return raus;
+}
+// ---- Listen ------------------------------------------------------------------
+/** Eine zugesagte Liste `data.<feld>`, Eintrag fuer Eintrag gelesen. */
+function liste(name, daten, feld, lesen) {
+    const roh = objekt(daten)?.[feld];
+    if (!Array.isArray(roh)) {
+        const grund = roh === undefined || roh === null
+            ? `Antwort enthaelt keine Liste (data.${feld} fehlt)`
+            : `Antwort ist unbrauchbar (data.${feld} ist keine Liste)`;
+        throw antwortfehler(name, grund);
+    }
+    return roh.map((e, i) => lesen({ name, pfad: `${feld}[${i}]` }, e));
+}
+/** Der Cursor der naechsten Seite; `null` am Ende. Etwas anderes als Text oder `null` ist kaputt. */
+function naechsterCursor(name, daten) {
+    const c = objekt(daten)?.nextCursor;
+    if (c === undefined || c === null)
+        return null;
+    if (typeof c !== 'string' || c === '')
+        throw antwortfehler(name, 'Antwort ist unbrauchbar (data.nextCursor)');
+    return c;
+}