@kreiseck/kasseneck-api 1.5.0 → 1.6.0

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

@@ -0,0 +1,67 @@
+/**
+ * Variantengruppen der Lager-API (Backend Stufe 5c): Gruppe anlegen (mit
+ * Matrix oder genannten Varianten), aendern oder stilllegen, eine Variante
+ * ergaenzen, Gruppen lesen.
+ *
+ * Eine Variante ist ein gewoehnlicher Artikel mit `variantGroupId` und
+ * `variantAttributes`; gelesen, gebucht und reserviert wird sie wie jeder
+ * Artikel. Die Gruppenantworten tragen nur die Kennungen der Varianten, die
+ * Artikel selbst liefert `listArticles({ variantGroupId })`.
+ *
+ * Wie in `schreiben.ts` geht die Anfrage flach hinaus, genau mit den Feldern,
+ * die der Aufrufer nennt (`undefined` faellt weg, `null` bleibt).
+ *
+ * **Vor dem Senden geprueft wird nur, was ohne Netz sicher falsch ist:**
+ * - `idempotencyKey` fehlt, ist leer oder laenger als 120 Zeichen (die drei
+ *   schreibenden Aufrufe);
+ * - `variantGroupId` fehlt oder ist leer;
+ * - `createMatrix: true` zusammen mit `variants` (schliessen sich aus);
+ * - `variants` ist keine Liste, ein Eintrag kein Objekt, `variantAttributes`
+ *   einer Variante fehlt oder ist kein Objekt;
+ * - ein Preis, eine Menge oder ein Einkaufspreis (auch in `defaults`) ist
+ *   keine Ganzzahl;
+ * - eine Aenderung nennt kein Feld, `active` ist nicht `false` oder steht
+ *   nicht allein, `addAttributeValues` ist kein Objekt.
+ * Die Grenzen (Merkmale, Werte, Matrix, aktive Varianten) prueft der Server:
+ * er darf sie anheben, ohne dass diese Paketversion dann falsch abweist.
+ *
+ * **Wiederholen** wie bei jedem Schreiben: nach `outcome: 'unknown'` denselben
+ * Aufruf mit **demselben** `idempotencyKey`; er wirkt genau einmal und liefert
+ * die gespeicherte Antwort. Ein neuer Schluessel legte die Gruppe ein zweites
+ * Mal an. Ein abgebrochenes Stilllegen vollendet jede Wiederholung von
+ * `updateVariantGroup({ active: false })`, auch mit neuem Schluessel.
+ */
+import type { InternerTransport } from '../client/aufrufe.js';
+import type { AddVariantRequest, Article, CreateVariantGroupRequest, UpdateVariantGroupRequest, VariantGroup, VariantGroupListQuery, VariantGroupPage } from './typen.js';
+/**
+ * Legt eine Variantengruppe an: mit `createMatrix: true` alle Kombinationen der
+ * Werte (hoechstens 100), sonst die genannten `variants[]` (hoechstens 100),
+ * ohne beides nur die Gruppe. Jede Variante entsteht als Artikel mit den
+ * Feldern wie bei `createArticle`; was sie nicht nennt, fuellen die Vorgaben.
+ * Antwort: die Gruppe mit `variants[]` (Kennung und Merkmale je Variante).
+ *
+ * Braucht die Anlage mehr Schreibvorgaenge, als in einen Vorgang passen,
+ * kommt `too_many_positions` mit `field` (`variants` bzw. `createMatrix`) und
+ * nichts ist geschrieben: weniger Varianten senden, den Rest per [addVariant].
+ */
+export declare function createVariantGroup(transport: InternerTransport, request: CreateVariantGroupRequest): Promise<VariantGroup>;
+/**
+ * Aendert eine aktive Gruppe (Name, Vorgaben, neue Werte) oder legt sie mit
+ * `active: false` still: die Gruppe und alle ihre Varianten, endgueltig. Die
+ * Antwort kommt erst, wenn alle Varianten stillgelegt sind. Bestehende
+ * Varianten aendern Name und Vorgaben nicht (dafuer `updateArticle`).
+ */
+export declare function updateVariantGroup(transport: InternerTransport, request: UpdateVariantGroupRequest): Promise<VariantGroup>;
+/**
+ * Legt eine Variante in einer aktiven Gruppe an. Antwort: der Artikel wie
+ * `createArticle`. Gibt es die Kombination schon, kommt
+ * `variant_already_exists` mit `articleId` der bestehenden Variante; nach dem
+ * Stilllegen einer Variante ist ihre Kombination wieder frei.
+ */
+export declare function addVariant(transport: InternerTransport, request: AddVariantRequest): Promise<Article>;
+/** Eine Variantengruppe mit ihren aktiven Varianten (eingefroren, wenn stillgelegt). */
+export declare function getVariantGroup(transport: InternerTransport, variantGroupId: string): Promise<VariantGroup>;
+/** Variantengruppen nach `updatedAt` aufsteigend; Filter `active` und `updatedSince` (inklusive). */
+export declare function listVariantGroups(transport: InternerTransport, query?: VariantGroupListQuery): Promise<VariantGroupPage>;
+/** Alle Variantengruppen der Abfrage, Seite fuer Seite ueber `nextCursor`. */
+export declare function iterateVariantGroups(transport: InternerTransport, query?: VariantGroupListQuery): AsyncGenerator<VariantGroup, void, undefined>;

package/dist/cjs/inventory/varianten.js

@@ -0,0 +1,150 @@
+"use strict";
+/**
+ * Variantengruppen der Lager-API (Backend Stufe 5c): Gruppe anlegen (mit
+ * Matrix oder genannten Varianten), aendern oder stilllegen, eine Variante
+ * ergaenzen, Gruppen lesen.
+ *
+ * Eine Variante ist ein gewoehnlicher Artikel mit `variantGroupId` und
+ * `variantAttributes`; gelesen, gebucht und reserviert wird sie wie jeder
+ * Artikel. Die Gruppenantworten tragen nur die Kennungen der Varianten, die
+ * Artikel selbst liefert `listArticles({ variantGroupId })`.
+ *
+ * Wie in `schreiben.ts` geht die Anfrage flach hinaus, genau mit den Feldern,
+ * die der Aufrufer nennt (`undefined` faellt weg, `null` bleibt).
+ *
+ * **Vor dem Senden geprueft wird nur, was ohne Netz sicher falsch ist:**
+ * - `idempotencyKey` fehlt, ist leer oder laenger als 120 Zeichen (die drei
+ *   schreibenden Aufrufe);
+ * - `variantGroupId` fehlt oder ist leer;
+ * - `createMatrix: true` zusammen mit `variants` (schliessen sich aus);
+ * - `variants` ist keine Liste, ein Eintrag kein Objekt, `variantAttributes`
+ *   einer Variante fehlt oder ist kein Objekt;
+ * - ein Preis, eine Menge oder ein Einkaufspreis (auch in `defaults`) ist
+ *   keine Ganzzahl;
+ * - eine Aenderung nennt kein Feld, `active` ist nicht `false` oder steht
+ *   nicht allein, `addAttributeValues` ist kein Objekt.
+ * Die Grenzen (Merkmale, Werte, Matrix, aktive Varianten) prueft der Server:
+ * er darf sie anheben, ohne dass diese Paketversion dann falsch abweist.
+ *
+ * **Wiederholen** wie bei jedem Schreiben: nach `outcome: 'unknown'` denselben
+ * Aufruf mit **demselben** `idempotencyKey`; er wirkt genau einmal und liefert
+ * die gespeicherte Antwort. Ein neuer Schluessel legte die Gruppe ein zweites
+ * Mal an. Ein abgebrochenes Stilllegen vollendet jede Wiederholung von
+ * `updateVariantGroup({ active: false })`, auch mit neuem Schluessel.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createVariantGroup = createVariantGroup;
+exports.updateVariantGroup = updateVariantGroup;
+exports.addVariant = addVariant;
+exports.getVariantGroup = getVariantGroup;
+exports.listVariantGroups = listVariantGroups;
+exports.iterateVariantGroups = iterateVariantGroups;
+const endpunkte_js_1 = require("./endpunkte.js");
+const lesen_js_1 = require("./lesen.js");
+const schreiben_js_1 = require("./schreiben.js");
+const istObjekt = (w) => w !== null && typeof w === 'object' && !Array.isArray(w);
+/** Vorgaben: nur der Preis ist eine Zahl mit Skala (Cent); `null` leert bzw. heisst „nicht angegeben“. */
+function vorgabenZahlen(name, w) {
+    if (w === undefined || w === null)
+        return;
+    if (!istObjekt(w))
+        throw (0, endpunkte_js_1.anfragefehler)(name, 'defaults muss ein Objekt oder null sein');
+    (0, schreiben_js_1.ganz)(name, 'defaults.unitPriceCents', w.unitPriceCents, { leerbar: true });
+}
+/** Eine Variante der Anfrage: Merkmale als Objekt, Zahlen ganzzahlig. */
+function variante(name, w, praefix) {
+    const stelle = praefix ? praefix.slice(0, -1) : 'Anfrage';
+    if (!istObjekt(w))
+        throw (0, endpunkte_js_1.anfragefehler)(name, `${stelle} muss ein Objekt sein`);
+    if (!istObjekt(w.variantAttributes)) {
+        throw (0, endpunkte_js_1.anfragefehler)(name, `${praefix}variantAttributes fehlt oder ist kein Objekt { merkmal: wert }`);
+    }
+    (0, schreiben_js_1.artikelZahlen)(name, w, praefix);
+}
+const gruppeAus = (name, daten) => (0, lesen_js_1.variantengruppe)({ name, pfad: 'variantGroup' }, (0, lesen_js_1.objekt)(daten)?.variantGroup);
+/**
+ * Legt eine Variantengruppe an: mit `createMatrix: true` alle Kombinationen der
+ * Werte (hoechstens 100), sonst die genannten `variants[]` (hoechstens 100),
+ * ohne beides nur die Gruppe. Jede Variante entsteht als Artikel mit den
+ * Feldern wie bei `createArticle`; was sie nicht nennt, fuellen die Vorgaben.
+ * Antwort: die Gruppe mit `variants[]` (Kennung und Merkmale je Variante).
+ *
+ * Braucht die Anlage mehr Schreibvorgaenge, als in einen Vorgang passen,
+ * kommt `too_many_positions` mit `field` (`variants` bzw. `createMatrix`) und
+ * nichts ist geschrieben: weniger Varianten senden, den Rest per [addVariant].
+ */
+async function createVariantGroup(transport, request) {
+    const name = 'createVariantGroup';
+    const p = (0, schreiben_js_1.anfrage)(name, request);
+    (0, schreiben_js_1.schluessel)(name, p, { pflicht: true });
+    if (p.createMatrix === true && p.variants !== null && p.variants !== undefined) {
+        throw (0, endpunkte_js_1.anfragefehler)(name, 'createMatrix und variants schliessen sich aus: entweder alle Kombinationen oder die genannten Varianten');
+    }
+    vorgabenZahlen(name, p.defaults);
+    if (p.variants !== null && p.variants !== undefined) {
+        if (!Array.isArray(p.variants))
+            throw (0, endpunkte_js_1.anfragefehler)(name, 'variants muss eine Liste sein');
+        p.variants.forEach((x, i) => variante(name, x, `variants[${i}].`));
+    }
+    return gruppeAus(name, await transport(name, p));
+}
+/**
+ * Aendert eine aktive Gruppe (Name, Vorgaben, neue Werte) oder legt sie mit
+ * `active: false` still: die Gruppe und alle ihre Varianten, endgueltig. Die
+ * Antwort kommt erst, wenn alle Varianten stillgelegt sind. Bestehende
+ * Varianten aendern Name und Vorgaben nicht (dafuer `updateArticle`).
+ */
+async function updateVariantGroup(transport, request) {
+    const name = 'updateVariantGroup';
+    const p = (0, schreiben_js_1.anfrage)(name, request);
+    (0, schreiben_js_1.schluessel)(name, p, { pflicht: true });
+    (0, endpunkte_js_1.kennung)(name, 'variantGroupId', p.variantGroupId);
+    const aenderungen = ['name', 'defaults', 'addAttributeValues'].filter((k) => p[k] !== undefined);
+    if (p.active !== undefined) {
+        if (p.active !== false)
+            throw (0, endpunkte_js_1.anfragefehler)(name, 'active kennt nur false (stilllegen); eine stillgelegte Gruppe bleibt stillgelegt');
+        if (aenderungen.length)
+            throw (0, endpunkte_js_1.anfragefehler)(name, 'active: false steht allein, ohne weitere Aenderung');
+    }
+    else if (!aenderungen.length) {
+        throw (0, endpunkte_js_1.anfragefehler)(name, 'die Aenderung nennt kein Feld');
+    }
+    vorgabenZahlen(name, p.defaults);
+    if (p.addAttributeValues !== undefined && !istObjekt(p.addAttributeValues)) {
+        throw (0, endpunkte_js_1.anfragefehler)(name, 'addAttributeValues muss ein Objekt { merkmal: [werte] } sein');
+    }
+    return gruppeAus(name, await transport(name, p));
+}
+/**
+ * Legt eine Variante in einer aktiven Gruppe an. Antwort: der Artikel wie
+ * `createArticle`. Gibt es die Kombination schon, kommt
+ * `variant_already_exists` mit `articleId` der bestehenden Variante; nach dem
+ * Stilllegen einer Variante ist ihre Kombination wieder frei.
+ */
+async function addVariant(transport, request) {
+    const name = 'addVariant';
+    const p = (0, schreiben_js_1.anfrage)(name, request);
+    (0, schreiben_js_1.schluessel)(name, p, { pflicht: true });
+    (0, endpunkte_js_1.kennung)(name, 'variantGroupId', p.variantGroupId);
+    variante(name, p, '');
+    return (0, schreiben_js_1.artikelAus)(name, await transport(name, p));
+}
+/** Eine Variantengruppe mit ihren aktiven Varianten (eingefroren, wenn stillgelegt). */
+async function getVariantGroup(transport, variantGroupId) {
+    const name = 'getVariantGroup';
+    return gruppeAus(name, await transport(name, { variantGroupId: (0, endpunkte_js_1.kennung)(name, 'variantGroupId', variantGroupId) }));
+}
+/** Variantengruppen nach `updatedAt` aufsteigend; Filter `active` und `updatedSince` (inklusive). */
+async function listVariantGroups(transport, query) {
+    const name = 'listVariantGroups';
+    const daten = await transport(name, (0, endpunkte_js_1.abfrage)(name, query));
+    return { variantGroups: (0, lesen_js_1.liste)(name, daten, 'variantGroups', lesen_js_1.variantengruppe), nextCursor: (0, lesen_js_1.naechsterCursor)(name, daten) };
+}
+/** Alle Variantengruppen der Abfrage, Seite fuer Seite ueber `nextCursor`. */
+function iterateVariantGroups(transport, query) {
+    const { cursor, ...rest } = query ?? {};
+    return (0, endpunkte_js_1.seitenweise)('listVariantGroups', cursor, async (c) => {
+        const s = await listVariantGroups(transport, { ...rest, cursor: c });
+        return { eintraege: s.variantGroups, nextCursor: s.nextCursor };
+    });
+}

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

@@ -1,6 +1,6 @@
 /**
  * Der Vertrag der Lager-API (Backend Stufe 5a lesen, 5b schreiben und
- * reservieren) als Daten: Endpunkte, Wertkataloge, Ereignisse, Fehler- und
+ * reservieren, 5c Varianten) als Daten: Endpunkte, Wertkataloge, Ereignisse, Fehler- und
  * Hinweiscodes, englisch wie am Draht `/v3`.
  *
  * Quelle ist der Vertrags-Export des Backends (`fixtures/v3/v3-vokabular.json`):
@@ -11,8 +11,8 @@
  * und `warningCodes.inventory`. `test/inventory.test.ts` haelt jede Liste
  * deckungsgleich mit dieser Datei; nichts hier wird geraten.
  */
-/** Die 27 Endpunkte (14 aus 5a, 13 aus 5b), in der Reihenfolge von `endpoints.public`. */
-export declare const INVENTORY_ENDPOINTS: readonly ["getArticle", "listArticles", "lookupArticleByCode", "listLocations", "getStock", "listStock", "listStockMovements", "createWebhook", "updateWebhook", "deleteWebhook", "listWebhooks", "sendWebhookTest", "rotateWebhookSecret", "listWebhookDeliveries", "createArticle", "updateArticle", "deactivateArticle", "receiveGoods", "transferStock", "recordStockLoss", "changeStockCondition", "reverseStockMovement", "createReservation", "extendReservation", "releaseReservation", "getReservation", "listReservations"];
+/** Die 32 Endpunkte (14 aus 5a, 13 aus 5b, 5 aus 5c), in der Reihenfolge von `endpoints.public`. */
+export declare const INVENTORY_ENDPOINTS: readonly ["getArticle", "listArticles", "lookupArticleByCode", "listLocations", "getStock", "listStock", "listStockMovements", "createWebhook", "updateWebhook", "deleteWebhook", "listWebhooks", "sendWebhookTest", "rotateWebhookSecret", "listWebhookDeliveries", "createArticle", "updateArticle", "deactivateArticle", "receiveGoods", "transferStock", "recordStockLoss", "changeStockCondition", "reverseStockMovement", "createReservation", "extendReservation", "releaseReservation", "getReservation", "listReservations", "createVariantGroup", "updateVariantGroup", "getVariantGroup", "listVariantGroups", "addVariant"];
 export type InventoryEndpoint = (typeof INVENTORY_ENDPOINTS)[number];
 /** Art eines Standorts (Katalog `STANDORT_TYP`). */
 export declare const LOCATION_TYPES: readonly ["warehouse", "store", "vehicle", "other"];
@@ -52,8 +52,12 @@ export type WebhookDeliveryStatus = (typeof WEBHOOK_DELIVERY_STATUSES)[number];
  * wie `getReservation`, mit dem Status danach: `reservation.released` und
  * `reservation.redeemed` kommen bei jeder wirksamen Freigabe bzw. Einloesung,
  * auch einer teilweisen (dann bleibt der Status `active`).
+ * `variant_group.created` und `variant_group.updated` (seit 1.6.0) tragen die
+ * Variantengruppe wie `getVariantGroup`; `updated` kommt nur bei einer aussen
+ * sichtbaren Aenderung (neuer Wert, neue oder stillgelegte Variante, Name,
+ * Vorgaben, Stilllegen der Gruppe).
  */
-export declare const INVENTORY_WEBHOOK_EVENTS: readonly ["stock.changed", "stock.below_minimum", "article.created", "article.updated", "article.deactivated", "reservation.expired", "reservation.released", "reservation.redeemed"];
+export declare const INVENTORY_WEBHOOK_EVENTS: readonly ["stock.changed", "stock.below_minimum", "article.created", "article.updated", "article.deactivated", "reservation.expired", "reservation.released", "reservation.redeemed", "variant_group.created", "variant_group.updated"];
 export type InventoryWebhookEventType = (typeof INVENTORY_WEBHOOK_EVENTS)[number];
 /**
  * Die Felder der Huelle jeder Zustellung, in der Reihenfolge am Draht. Statt
@@ -81,8 +85,21 @@ export declare const INVENTORY_LIST_LIMIT_MAX = 200;
  * [inventoryShortfalls]), `code_taken` und `external_id_taken` (mit `field` und
  * `articleId` des Artikels, dem der Code gehoert), `stock_kind_locked`,
  * `reservation_not_found`, `reservation_not_active` …
+ *
+ * Seit 1.6.0 dahinter die Codes der Variantengruppen: `variant_group_not_found`
+ * (unbekannte Kennung), `variant_already_exists` (die Kombination gibt es in der
+ * Gruppe schon, dann mit `articleId` der bestehenden Variante, oder sie steht
+ * zweimal in `variants[]`; jeweils mit `field`),
+ * `invalid_variant_attributes` (ein Merkmal fehlt, ist unbekannt oder sein Wert
+ * steht nicht in der Werteliste; `field` und `errors[]`),
+ * `variant_group_inactive` (stillgelegte Gruppe: kein `addVariant`, keine
+ * Aenderung ausser erneutem Stilllegen) und `variant_limit` (mehr als
+ * [VARIANT_GROUP_ACTIVE_MAX] aktive Varianten je Gruppe). Wiederverwendet:
+ * `too_many_positions` traegt bei Varianten `field` (`variants`,
+ * `createMatrix` bzw. `externalIds` bei `addVariant`): die Anfrage braeuchte
+ * mehr Schreibvorgaenge, als in einen Vorgang passen; geschrieben wurde nichts.
  */
-export declare const INVENTORY_ERROR_CODES: readonly ["validation", "invalid_cursor", "article_not_found", "webhook_not_found", "webhook_limit", "invalid_webhook_url", "event_not_subscribed", "webhook_inactive", "inventory_api_not_enabled", "module_inactive", "rate_limited", "server_error", "idempotency_key_required", "idempotency_conflict", "location_not_found", "location_inactive", "invalid_location", "invalid_locations", "invalid_transfer", "operation_not_found", "already_reversed", "reversal_not_possible", "reversal_not_supported", "exceeds_stock", "no_positions", "too_many_positions", "invalid_step", "invalid_quantity", "invalid_amount", "invalid_price", "negative_value", "invalid_reason", "note_required", "withdrawal_type_required", "invalid_method", "invalid_stock_kind", "invalid_minimum", "invalid_dimensions", "weight_missing", "invalid_landed_cost", "invalid_distribution", "landed_costs_mismatch", "return_totals_mismatch", "lot_not_found", "invalid_serial", "serial_required", "serial_not_allowed", "serial_already_exists", "serial_not_in_stock", "code_taken", "external_id_taken", "group_not_found", "revenue_group_not_found", "stock_kind_locked", "article_inactive", "invalid_position", "invalid_condition", "reason_required", "insufficient_available", "reservation_not_found", "reservation_not_active"];
+export declare const INVENTORY_ERROR_CODES: readonly ["validation", "invalid_cursor", "article_not_found", "webhook_not_found", "webhook_limit", "invalid_webhook_url", "event_not_subscribed", "webhook_inactive", "inventory_api_not_enabled", "module_inactive", "rate_limited", "server_error", "idempotency_key_required", "idempotency_conflict", "location_not_found", "location_inactive", "invalid_location", "invalid_locations", "invalid_transfer", "operation_not_found", "already_reversed", "reversal_not_possible", "reversal_not_supported", "exceeds_stock", "no_positions", "too_many_positions", "invalid_step", "invalid_quantity", "invalid_amount", "invalid_price", "negative_value", "invalid_reason", "note_required", "withdrawal_type_required", "invalid_method", "invalid_stock_kind", "invalid_minimum", "invalid_dimensions", "weight_missing", "invalid_landed_cost", "invalid_distribution", "landed_costs_mismatch", "return_totals_mismatch", "lot_not_found", "invalid_serial", "serial_required", "serial_not_allowed", "serial_already_exists", "serial_not_in_stock", "code_taken", "external_id_taken", "group_not_found", "revenue_group_not_found", "stock_kind_locked", "article_inactive", "invalid_position", "invalid_condition", "reason_required", "insufficient_available", "reservation_not_found", "reservation_not_active", "variant_group_not_found", "variant_already_exists", "invalid_variant_attributes", "variant_group_inactive", "variant_limit"];
 export type InventoryErrorCode = (typeof INVENTORY_ERROR_CODES)[number];
 /**
  * Codes, die Anmeldung und Rand auf jedem Lager-Aufruf erzeugen koennen,
@@ -134,3 +151,21 @@ export declare const INVENTORY_IDEMPOTENCY_KEY_MAX = 120;
 /** Kuerzeste und laengste Haltedauer einer Reservierung in Minuten (`expiresInMinutes`, 30 Tage). */
 export declare const RESERVATION_MINUTES_MIN = 5;
 export declare const RESERVATION_MINUTES_MAX = 43200;
+/**
+ * Grenzen einer Variantengruppe, wie das Backend sie prueft. Das Paket prueft
+ * sie **nicht** vor dem Senden: der Server darf sie anheben, ohne dass eine
+ * aeltere Paketversion dann faelschlich abweist. Wer darueber liegt, bekommt
+ * `validation` (Merkmale, Werte, Matrix, `variants[]`) bzw. `variant_limit`.
+ *
+ * - [VARIANT_ATTRIBUTES_MAX] Merkmale je Gruppe (Schluessel `^[a-z0-9_]{1,32}$`,
+ *   eindeutig; `__…__` ist reserviert),
+ * - [VARIANT_VALUES_MAX] Werte je Merkmal (je 1–30 Zeichen, eindeutig ohne
+ *   Gross/Klein),
+ * - [VARIANT_MATRIX_MAX] Kombinationen bei `createMatrix: true` und hoechstens
+ *   so viele Eintraege in `variants[]` je Anfrage,
+ * - [VARIANT_GROUP_ACTIVE_MAX] aktive Varianten je Gruppe.
+ */
+export declare const VARIANT_ATTRIBUTES_MAX = 3;
+export declare const VARIANT_VALUES_MAX = 30;
+export declare const VARIANT_MATRIX_MAX = 100;
+export declare const VARIANT_GROUP_ACTIVE_MAX = 250;

package/dist/cjs/inventory/vertrag.js

@@ -1,7 +1,7 @@
 "use strict";
 /**
  * Der Vertrag der Lager-API (Backend Stufe 5a lesen, 5b schreiben und
- * reservieren) als Daten: Endpunkte, Wertkataloge, Ereignisse, Fehler- und
+ * reservieren, 5c Varianten) als Daten: Endpunkte, Wertkataloge, Ereignisse, Fehler- und
  * Hinweiscodes, englisch wie am Draht `/v3`.
  *
  * Quelle ist der Vertrags-Export des Backends (`fixtures/v3/v3-vokabular.json`):
@@ -13,8 +13,8 @@
  * deckungsgleich mit dieser Datei; nichts hier wird geraten.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-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.INVENTORY_REQUEST_ERROR_CODES = exports.INVENTORY_ERROR_CODES = exports.INVENTORY_LIST_LIMIT_MAX = exports.INVENTORY_WEBHOOK_LIMIT = exports.INVENTORY_WEBHOOK_ENVELOPE_FIELDS = exports.INVENTORY_WEBHOOK_EVENTS = exports.WEBHOOK_DELIVERY_STATUSES = exports.STOCK_CHANGE_CAUSES = exports.STOCK_CONDITIONS = exports.STOCK_MOVEMENT_SOURCES = exports.STOCK_MOVEMENT_TYPES = exports.LOCATION_TYPES = exports.INVENTORY_ENDPOINTS = void 0;
-/** Die 27 Endpunkte (14 aus 5a, 13 aus 5b), in der Reihenfolge von `endpoints.public`. */
+exports.VARIANT_GROUP_ACTIVE_MAX = exports.VARIANT_MATRIX_MAX = exports.VARIANT_VALUES_MAX = exports.VARIANT_ATTRIBUTES_MAX = 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.INVENTORY_REQUEST_ERROR_CODES = exports.INVENTORY_ERROR_CODES = exports.INVENTORY_LIST_LIMIT_MAX = exports.INVENTORY_WEBHOOK_LIMIT = exports.INVENTORY_WEBHOOK_ENVELOPE_FIELDS = exports.INVENTORY_WEBHOOK_EVENTS = exports.WEBHOOK_DELIVERY_STATUSES = exports.STOCK_CHANGE_CAUSES = exports.STOCK_CONDITIONS = exports.STOCK_MOVEMENT_SOURCES = exports.STOCK_MOVEMENT_TYPES = exports.LOCATION_TYPES = exports.INVENTORY_ENDPOINTS = void 0;
+/** Die 32 Endpunkte (14 aus 5a, 13 aus 5b, 5 aus 5c), in der Reihenfolge von `endpoints.public`. */
 exports.INVENTORY_ENDPOINTS = [
     'getArticle',
     'listArticles',
@@ -43,6 +43,11 @@ exports.INVENTORY_ENDPOINTS = [
     'releaseReservation',
     'getReservation',
     'listReservations',
+    'createVariantGroup',
+    'updateVariantGroup',
+    'getVariantGroup',
+    'listVariantGroups',
+    'addVariant',
 ];
 /** Art eines Standorts (Katalog `STANDORT_TYP`). */
 exports.LOCATION_TYPES = ['warehouse', 'store', 'vehicle', 'other'];
@@ -116,6 +121,10 @@ exports.WEBHOOK_DELIVERY_STATUSES = ['delivered', 'pending', 'failed', 'dropped'
  * wie `getReservation`, mit dem Status danach: `reservation.released` und
  * `reservation.redeemed` kommen bei jeder wirksamen Freigabe bzw. Einloesung,
  * auch einer teilweisen (dann bleibt der Status `active`).
+ * `variant_group.created` und `variant_group.updated` (seit 1.6.0) tragen die
+ * Variantengruppe wie `getVariantGroup`; `updated` kommt nur bei einer aussen
+ * sichtbaren Aenderung (neuer Wert, neue oder stillgelegte Variante, Name,
+ * Vorgaben, Stilllegen der Gruppe).
  */
 exports.INVENTORY_WEBHOOK_EVENTS = [
     'stock.changed',
@@ -126,6 +135,8 @@ exports.INVENTORY_WEBHOOK_EVENTS = [
     'reservation.expired',
     'reservation.released',
     'reservation.redeemed',
+    'variant_group.created',
+    'variant_group.updated',
 ];
 /**
  * Die Felder der Huelle jeder Zustellung, in der Reihenfolge am Draht. Statt
@@ -153,6 +164,19 @@ exports.INVENTORY_LIST_LIMIT_MAX = 200;
  * [inventoryShortfalls]), `code_taken` und `external_id_taken` (mit `field` und
  * `articleId` des Artikels, dem der Code gehoert), `stock_kind_locked`,
  * `reservation_not_found`, `reservation_not_active` …
+ *
+ * Seit 1.6.0 dahinter die Codes der Variantengruppen: `variant_group_not_found`
+ * (unbekannte Kennung), `variant_already_exists` (die Kombination gibt es in der
+ * Gruppe schon, dann mit `articleId` der bestehenden Variante, oder sie steht
+ * zweimal in `variants[]`; jeweils mit `field`),
+ * `invalid_variant_attributes` (ein Merkmal fehlt, ist unbekannt oder sein Wert
+ * steht nicht in der Werteliste; `field` und `errors[]`),
+ * `variant_group_inactive` (stillgelegte Gruppe: kein `addVariant`, keine
+ * Aenderung ausser erneutem Stilllegen) und `variant_limit` (mehr als
+ * [VARIANT_GROUP_ACTIVE_MAX] aktive Varianten je Gruppe). Wiederverwendet:
+ * `too_many_positions` traegt bei Varianten `field` (`variants`,
+ * `createMatrix` bzw. `externalIds` bei `addVariant`): die Anfrage braeuchte
+ * mehr Schreibvorgaenge, als in einen Vorgang passen; geschrieben wurde nichts.
  */
 exports.INVENTORY_ERROR_CODES = [
     'validation',
@@ -216,6 +240,11 @@ exports.INVENTORY_ERROR_CODES = [
     'insufficient_available',
     'reservation_not_found',
     'reservation_not_active',
+    'variant_group_not_found',
+    'variant_already_exists',
+    'invalid_variant_attributes',
+    'variant_group_inactive',
+    'variant_limit',
 ];
 /**
  * Codes, die Anmeldung und Rand auf jedem Lager-Aufruf erzeugen koennen,
@@ -289,3 +318,22 @@ exports.INVENTORY_IDEMPOTENCY_KEY_MAX = 120;
 /** Kuerzeste und laengste Haltedauer einer Reservierung in Minuten (`expiresInMinutes`, 30 Tage). */
 exports.RESERVATION_MINUTES_MIN = 5;
 exports.RESERVATION_MINUTES_MAX = 43_200;
+// ---- Varianten (Backend Stufe 5c, seit 1.6.0) -----------------------------------
+/**
+ * Grenzen einer Variantengruppe, wie das Backend sie prueft. Das Paket prueft
+ * sie **nicht** vor dem Senden: der Server darf sie anheben, ohne dass eine
+ * aeltere Paketversion dann faelschlich abweist. Wer darueber liegt, bekommt
+ * `validation` (Merkmale, Werte, Matrix, `variants[]`) bzw. `variant_limit`.
+ *
+ * - [VARIANT_ATTRIBUTES_MAX] Merkmale je Gruppe (Schluessel `^[a-z0-9_]{1,32}$`,
+ *   eindeutig; `__…__` ist reserviert),
+ * - [VARIANT_VALUES_MAX] Werte je Merkmal (je 1–30 Zeichen, eindeutig ohne
+ *   Gross/Klein),
+ * - [VARIANT_MATRIX_MAX] Kombinationen bei `createMatrix: true` und hoechstens
+ *   so viele Eintraege in `variants[]` je Anfrage,
+ * - [VARIANT_GROUP_ACTIVE_MAX] aktive Varianten je Gruppe.
+ */
+exports.VARIANT_ATTRIBUTES_MAX = 3;
+exports.VARIANT_VALUES_MAX = 30;
+exports.VARIANT_MATRIX_MAX = 100;
+exports.VARIANT_GROUP_ACTIVE_MAX = 250;

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

@@ -39,10 +39,13 @@ export declare function verifyInventoryWebhookSignature(secret: string | readonl
  * Liest eine Zustellung als typisiertes Ereignis. Vorher die Signatur pruefen
  * ([verifyInventoryWebhookSignature]).
  *
- * - Ein Ereignis, das diese Paketversion nicht kennt (etwa `variant_group.*`
- *   einer spaeteren Stufe), ergibt `null`: mit 2xx antworten und uebergehen.
+ * - Ein Ereignis, das diese Paketversion nicht kennt (eines einer spaeteren
+ *   Stufe), ergibt `null`: mit 2xx antworten und uebergehen.
  * - `reservation.expired|released|redeemed` tragen die Reservierung wie
  *   `getReservation`, mit dem Status nach dem Vorgang (seit 1.5.0).
+ * - `variant_group.created|updated` tragen die Gruppe wie `getVariantGroup`
+ *   (seit 1.6.0). Zwei Zustellungen koennen sich ueberholen: den Stand nur
+ *   uebernehmen, wenn `data.updatedAt` neuer ist als der gespeicherte.
  * - Ein Rumpf, der keine Huelle ist, oder eine Bruchzahl in einer Menge wirft
  *   `KasseneckValidationError` (`scope: 'response'`).
  *

package/dist/cjs/inventory/webhook.js

@@ -65,10 +65,13 @@ function kaputt(grund) {
  * Liest eine Zustellung als typisiertes Ereignis. Vorher die Signatur pruefen
  * ([verifyInventoryWebhookSignature]).
  *
- * - Ein Ereignis, das diese Paketversion nicht kennt (etwa `variant_group.*`
- *   einer spaeteren Stufe), ergibt `null`: mit 2xx antworten und uebergehen.
+ * - Ein Ereignis, das diese Paketversion nicht kennt (eines einer spaeteren
+ *   Stufe), ergibt `null`: mit 2xx antworten und uebergehen.
  * - `reservation.expired|released|redeemed` tragen die Reservierung wie
  *   `getReservation`, mit dem Status nach dem Vorgang (seit 1.5.0).
+ * - `variant_group.created|updated` tragen die Gruppe wie `getVariantGroup`
+ *   (seit 1.6.0). Zwei Zustellungen koennen sich ueberholen: den Stand nur
+ *   uebernehmen, wenn `data.updatedAt` neuer ist als der gespeicherte.
  * - Ein Rumpf, der keine Huelle ist, oder eine Bruchzahl in einer Menge wirft
  *   `KasseneckValidationError` (`scope: 'response'`).
  *
@@ -110,6 +113,9 @@ function parseInventoryWebhookEvent(rawBody) {
         case 'reservation.released':
         case 'reservation.redeemed':
             return { ...huelle, type: huelle.type, data: (0, lesen_js_1.reservierung)(ort, data) };
+        case 'variant_group.created':
+        case 'variant_group.updated':
+            return { ...huelle, type: huelle.type, data: (0, lesen_js_1.variantengruppe)(ort, data) };
         default:
             return { ...huelle, type: huelle.type, data: (0, lesen_js_1.artikel)(ort, data) };
     }

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

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

package/dist/cjs/invoice/endpunkte.js

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

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

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

package/dist/cjs/pos/texte.js

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

package/dist/cjs/stored/vokabular.d.ts

@@ -1,5 +1,5 @@
 /** Fingerabdruck des Vertrags-Exports, aus dem diese Datei stammt (`_quelle.sha256`). */
-export declare const VOKABULAR_QUELLE = "d351a778c02888291e325068f96156ad1346859f6ff97bae27f91089e9619e8c";
+export declare const VOKABULAR_QUELLE = "6e6eae018f1e84116d3942cbfd35bc2d5d6f5c5e5551823c7ed88f15ed407744";
 /** Schema-Notation des Vertrags: Blatt 'aussen': 'innen', Objekt { __: 'innen', ... }, Liste [ { __: 'innen', ... } ]. */
 export type SchemaEintrag = string | SchemaObjekt | readonly [SchemaObjekt];
 export interface SchemaObjekt {

package/dist/cjs/stored/vokabular.js

@@ -4,7 +4,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.KATALOGE = exports.ARTIKEL_FELDER = exports.SCHEMAS = exports.VOKABULAR_QUELLE = void 0;
 /** Fingerabdruck des Vertrags-Exports, aus dem diese Datei stammt (`_quelle.sha256`). */
-exports.VOKABULAR_QUELLE = "d351a778c02888291e325068f96156ad1346859f6ff97bae27f91089e9619e8c";
+exports.VOKABULAR_QUELLE = "6e6eae018f1e84116d3942cbfd35bc2d5d6f5c5e5551823c7ed88f15ed407744";
 /** Schema je Endpunkt (aussen -> innen) und Wertverweise auf die Kataloge. */
 exports.SCHEMAS = {
     "getReceipt": {

package/dist/cjs/version.d.ts

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

package/dist/cjs/version.js

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