@kreiseck/kasseneck-api 1.5.0 → 1.6.0

package/dist/esm/client/transport.js

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

package/dist/esm/index.d.ts

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

package/dist/esm/index.js

@@ -1,6 +1,6 @@
 export { ReceiptType, VatRate, KeckPaymentMethod, CreditCardProvider, VoucherType, VoucherAction, StripeLinkMode, } from './enums/index.js';
 export { toReceiptItemPayload, fromReceiptItemPayload, receiptItemTotalCents, receiptItemIsValid, negateReceiptItem, isTipItem, toVoucherPayload, fromVoucherPayload, voucherIsValid, toReceiptPayload, fromReceiptPayload, receiptSubSumCents, receiptSumCents, RETURN_DISPOSITIONS, CANCELLATION_REASONS, CANCELLATION_STATUSES, CANCELLATION_ERROR_CODES, CANCELLATION_RESERVATION_MS, isCancellationReason, isReturnDisposition, isCancellationErrorCode, cancellationErrorCode, isCancellationError, cancellationFieldErrors, fromReceiptPaymentPayload, toReceiptPaymentPayload, PAYMENT_ERROR_CODES, isPaymentErrorCode, paymentErrorCode, isPaymentError, paymentFieldErrors, RECEIPT_EMAIL_ERROR_CODES, RECEIPT_EMAIL_SEND_ERROR_CODES, RECEIPT_EMAIL_VIAS, isReceiptEmailErrorCode, receiptEmailErrorCode, isReceiptEmailError, receiptEmailFieldErrors, RECEIPT_ERROR_CODES, isReceiptErrorCode, receiptErrorCode, isReceiptError, receiptFieldErrors, remainingQuantities, fromReceiptCompanyPayload, receiptCompanyTaxInfo, fromCashregisterPayload, fromReceiptSummaryPayload, ZERO_KINDS, isZeroKind, reportMonthFromDate, previousReportMonth, nextReportMonth, reportMonthKey, reportMonthReadable, toStripeUrlSessionPayload, fromStripeUrlSessionPayload, toHobexReceiptPayload, fromHobexReceiptPayload, hobexReceiptToCardPaymentData, hobexReceiptNeedsSignature, } from './models/index.js';
-export { apiKeyAuth, registerUserAuth, DEFAULT_BASE_URL, POS_BASE_URL, DEFAULT_TIMEOUT_MS, ALL_CALLS, PUBLIC_CALLS, POS_CALLS, createTransport, createBinaryTransport, KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, CLIENT_ERROR_CODES, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, isOutcomeUnknown, sellReceipt, sellReceiptWithCompany, paymentsExpectedCents, cardRefundReference, receiptLayoutFromResult, cancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, listMyCashregisters, checkVoucherCombinationError, sendReceiptEmail, downloadDailyReport, downloadMonthlyReport, getReportV2, getCashboxStatus, getSignatureStatus, createKasseneckApi, } from './client/index.js';
+export { apiKeyAuth, registerUserAuth, DEFAULT_BASE_URL, POS_BASE_URL, DEFAULT_TIMEOUT_MS, ALL_CALLS, PUBLIC_CALLS, POS_CALLS, UNKNOWN_OUTCOME_CALLS, createTransport, createBinaryTransport, KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, CLIENT_ERROR_CODES, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, isOutcomeUnknown, sellReceipt, sellReceiptWithCompany, paymentsExpectedCents, cardRefundReference, receiptLayoutFromResult, cancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, listMyCashregisters, checkVoucherCombinationError, sendReceiptEmail, downloadDailyReport, downloadMonthlyReport, getReportV2, getCashboxStatus, getSignatureStatus, createKasseneckApi, } from './client/index.js';
 export { receiptDueCents, receiptDueBreakdown, ReceiptDueError, RECEIPT_DUE_ERROR_REASONS, isReceiptDueError, } from './receipt/due.js';
 export { parseServerTimeStamp, toViennaWallClock } from './vienna-time.js';
 export { POS_BUSINESS_DEFAULTS, POS_DEVICE_DEFAULTS, mergePosSettings, fromArticleGroupPayload, fromPosArticlePayload, listMyArticleGroups, listMyArticles, getPosSettings, setMyPosSettings, setMyRegisterDeviceSettings, distributeDiscount, cancelScopeOf, receiptsScopeOf, stockViewOf, } from './pos/index.js';

package/dist/esm/inventory/api.d.ts

@@ -1,10 +1,10 @@
 /**
  * Fassade ueber den Aufrufen der Lager-API (lesen, Webhooks, schreiben,
- * reservieren): Schluessel einmal binden, dann rufen. Wie [createInvoiceApi] bewusst keine Klasse; die Aufrufe sind freie
+ * reservieren, Varianten): Schluessel einmal binden, dann rufen. Wie [createInvoiceApi] bewusst keine Klasse; die Aufrufe sind freie
  * Funktionen (endpunkte.ts) und bleiben einzeln importierbar.
  */
 import { type FetchLike } from '../client/transport.js';
-import type { Article, ChangeStockConditionRequest, CreateArticleRequest, CreateReservationRequest, DeactivateArticleRequest, ExtendReservationRequest, GoodsReceiptPreview, GoodsReceiptPreviewRequest, ReceiveGoodsRequest, RecordStockLossRequest, ReleaseReservationRequest, Reservation, ReservationListQuery, ReservationPage, ReverseStockMovementRequest, StockOperation, TransferStockRequest, UpdateArticleRequest, ArticleListQuery, ArticleLookup, ArticlePage, CreateInventoryWebhookOptions, InventoryWebhook, InventoryWebhookDelivery, InventoryWebhookList, InventoryWebhookPatch, InventoryWebhookTestResult, InventoryWebhookWithSecret, Location, StockLevel, StockListQuery, StockMovement, StockMovementPage, StockMovementQuery, StockPage, StockResult } from './typen.js';
+import type { AddVariantRequest, CreateVariantGroupRequest, UpdateVariantGroupRequest, VariantGroup, VariantGroupListQuery, VariantGroupPage, Article, ChangeStockConditionRequest, CreateArticleRequest, CreateReservationRequest, DeactivateArticleRequest, ExtendReservationRequest, GoodsReceiptPreview, GoodsReceiptPreviewRequest, ReceiveGoodsRequest, RecordStockLossRequest, ReleaseReservationRequest, Reservation, ReservationListQuery, ReservationPage, ReverseStockMovementRequest, StockOperation, TransferStockRequest, UpdateArticleRequest, ArticleListQuery, ArticleLookup, ArticlePage, CreateInventoryWebhookOptions, InventoryWebhook, InventoryWebhookDelivery, InventoryWebhookList, InventoryWebhookPatch, InventoryWebhookTestResult, InventoryWebhookWithSecret, Location, StockLevel, StockListQuery, StockMovement, StockMovementPage, StockMovementQuery, StockPage, StockResult } from './typen.js';
 import type { InventoryWebhookEventType } from './vertrag.js';
 export interface InventoryClientOptions {
     /** `api_key` des Kontos (`kr_live_…` / `kr_test_…`). Gehoert auf einen Server. */
@@ -57,5 +57,13 @@ export interface InventoryClient {
     getReservation(reservationId: string): Promise<Reservation>;
     listReservations(query?: ReservationListQuery): Promise<ReservationPage>;
     iterateReservations(query?: ReservationListQuery): AsyncGenerator<Reservation, void, undefined>;
+    createVariantGroup(request: CreateVariantGroupRequest): Promise<VariantGroup>;
+    /** Name, Vorgaben, neue Werte; oder `active: false` (Gruppe und alle Varianten stilllegen, endgueltig). */
+    updateVariantGroup(request: UpdateVariantGroupRequest): Promise<VariantGroup>;
+    /** Eine Variante mehr; Antwort: der Artikel wie `createArticle`. */
+    addVariant(request: AddVariantRequest): Promise<Article>;
+    getVariantGroup(variantGroupId: string): Promise<VariantGroup>;
+    listVariantGroups(query?: VariantGroupListQuery): Promise<VariantGroupPage>;
+    iterateVariantGroups(query?: VariantGroupListQuery): AsyncGenerator<VariantGroup, void, undefined>;
 }
 export declare function createInventoryClient(options: InventoryClientOptions): InventoryClient;

package/dist/esm/inventory/api.js

@@ -1,12 +1,13 @@
 /**
  * Fassade ueber den Aufrufen der Lager-API (lesen, Webhooks, schreiben,
- * reservieren): Schluessel einmal binden, dann rufen. Wie [createInvoiceApi] bewusst keine Klasse; die Aufrufe sind freie
+ * reservieren, Varianten): Schluessel einmal binden, dann rufen. Wie [createInvoiceApi] bewusst keine Klasse; die Aufrufe sind freie
  * Funktionen (endpunkte.ts) und bleiben einzeln importierbar.
  */
 import { createTransport } from '../client/transport.js';
 import { inventoryKeyAuth } from './auth.js';
 import { createWebhook, deleteWebhook, getArticle, getStock, iterateArticles, iterateStock, iterateStockMovements, listArticles, listLocations, listStock, listStockMovements, listWebhookDeliveries, listWebhooks, lookupArticleByCode, rotateWebhookSecret, sendWebhookTest, updateWebhook, } from './endpunkte.js';
 import { changeStockCondition, createArticle, createReservation, deactivateArticle, extendReservation, getReservation, iterateReservations, listReservations, previewGoodsReceipt, receiveGoods, recordStockLoss, releaseReservation, reverseStockMovement, transferStock, updateArticle, } from './schreiben.js';
+import { addVariant, createVariantGroup, getVariantGroup, iterateVariantGroups, listVariantGroups, updateVariantGroup, } from './varianten.js';
 export function createInventoryClient(options) {
     const rufen = createTransport({
         auth: inventoryKeyAuth({ apiKey: options.apiKey }),
@@ -47,5 +48,11 @@ export function createInventoryClient(options) {
         getReservation: (id) => getReservation(rufen, id),
         listReservations: (q) => listReservations(rufen, q),
         iterateReservations: (q) => iterateReservations(rufen, q),
+        createVariantGroup: (r) => createVariantGroup(rufen, r),
+        updateVariantGroup: (r) => updateVariantGroup(rufen, r),
+        addVariant: (r) => addVariant(rufen, r),
+        getVariantGroup: (id) => getVariantGroup(rufen, id),
+        listVariantGroups: (q) => listVariantGroups(rufen, q),
+        iterateVariantGroups: (q) => iterateVariantGroups(rufen, q),
     };
 }

package/dist/esm/inventory/endpunkte.d.ts

@@ -1,7 +1,8 @@
 /**
  * Die Aufrufe der Lager-API: Artikel, Standorte, Bestand und Bewegungen
  * lesen, Konto-Webhooks verwalten (Backend Stufe 5a). Die schreibenden
- * Aufrufe (Stufe 5b) stehen in `schreiben.ts` und teilen die Helfer hier.
+ * Aufrufe (Stufe 5b) stehen in `schreiben.ts`, die Variantengruppen (Stufe 5c)
+ * in `varianten.ts`; beide teilen die Helfer hier.
  *
  * Jede Funktion nimmt den Transport als ersten Parameter und ist einzeln
  * importierbar; die Fassade [createInventoryClient] bindet ihn nur einmal.

package/dist/esm/inventory/endpunkte.js

@@ -1,7 +1,8 @@
 /**
  * Die Aufrufe der Lager-API: Artikel, Standorte, Bestand und Bewegungen
  * lesen, Konto-Webhooks verwalten (Backend Stufe 5a). Die schreibenden
- * Aufrufe (Stufe 5b) stehen in `schreiben.ts` und teilen die Helfer hier.
+ * Aufrufe (Stufe 5b) stehen in `schreiben.ts`, die Variantengruppen (Stufe 5c)
+ * in `varianten.ts`; beide teilen die Helfer hier.
  *
  * Jede Funktion nimmt den Transport als ersten Parameter und ist einzeln
  * importierbar; die Fassade [createInventoryClient] bindet ihn nur einmal.

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

@@ -2,7 +2,8 @@
  * `@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).
+ * Bestand buchen und Ware reservieren (Stufe 5b, seit 1.5.0);
+ * Variantengruppen (Stufe 5c, seit 1.6.0).
  *
  * Ein eigener Unterpfad wie `invoice`: der `api_key` eines Kontos gehoert auf
  * einen **Server** (etwa das Backend eines Online-Shops) und soll nicht
@@ -16,6 +17,7 @@ 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 { addVariant, createVariantGroup, getVariantGroup, iterateVariantGroups, listVariantGroups, updateVariantGroup, } from './varianten.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';
+export type { AddVariantRequest, Article, ArticleInput, ArticleListQuery, ArticleLookup, ArticlePage, ChangeStockConditionRequest, CreateArticleRequest, CreateInventoryWebhookOptions, CreateReservationRequest, CreateVariantGroupRequest, 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, UpdateVariantGroupRequest, VariantAttribute, VariantGroup, VariantGroupDefaults, VariantGroupDefaultsInput, VariantGroupListQuery, VariantGroupMember, VariantGroupPage, VariantInput, } 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, VARIANT_ATTRIBUTES_MAX, VARIANT_VALUES_MAX, VARIANT_MATRIX_MAX, VARIANT_GROUP_ACTIVE_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/esm/inventory/index.js

@@ -2,7 +2,8 @@
  * `@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).
+ * Bestand buchen und Ware reservieren (Stufe 5b, seit 1.5.0);
+ * Variantengruppen (Stufe 5c, seit 1.6.0).
  *
  * Ein eigener Unterpfad wie `invoice`: der `api_key` eines Kontos gehoert auf
  * einen **Server** (etwa das Backend eines Online-Shops) und soll nicht
@@ -16,5 +17,6 @@ export { inventoryKeyAuth } from './auth.js';
 export { isInventoryError, isInventoryErrorCode, inventoryErrorCode, inventoryFieldErrors, inventoryRetryAfterSec, inventoryShortfalls, isInventoryWarningCode, } 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 { addVariant, createVariantGroup, getVariantGroup, iterateVariantGroups, listVariantGroups, updateVariantGroup, } from './varianten.js';
 export { verifyInventoryWebhookSignature, parseInventoryWebhookEvent, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_EVENT_HEADER, WEBHOOK_DELIVERY_HEADER, WEBHOOK_TOLERANCE_SEC, } from './webhook.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, } from './vertrag.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, VARIANT_ATTRIBUTES_MAX, VARIANT_VALUES_MAX, VARIANT_MATRIX_MAX, VARIANT_GROUP_ACTIVE_MAX, } from './vertrag.js';

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

@@ -12,7 +12,7 @@
  * 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';
+import type { Article, GoodsReceiptPreviewLine, InventoryShortfall, InventoryWebhook, InventoryWebhookDelivery, InventoryWebhookTestDelivery, Location, Reservation, StockBelowMinimumEventData, StockChangedEventData, StockLevel, StockMovement, StockOperation, StockValue, VariantGroup } from './typen.js';
 type Roh = Record<string, unknown>;
 /** Ein Leser bekommt den Vorgang (fuer die Meldung) und den Pfad im Rumpf. */
 export interface Ort {
@@ -38,6 +38,12 @@ export declare function vorschauZeile(ort: Ort, w: unknown): GoodsReceiptPreview
 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 Variantengruppe. `attributes` und `variants` sind zugesagte Listen:
+ * fehlen sie, ist die Antwort kaputt (eine leere Liste hiesse „keine Merkmale“
+ * bzw. „keine Varianten“).
+ */
+export declare function variantengruppe(ort: Ort, w: unknown): VariantGroup;
 /** 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. */

package/dist/esm/inventory/lesen.js

@@ -381,6 +381,80 @@ export function fehlmengen(roh) {
     }
     return raus;
 }
+// ---- Varianten (Stufe 5c) ------------------------------------------------------------
+/** Eine Liste von Texten (Werte eines Merkmals); etwas anderes ist kaputt. */
+function textliste(ort, feld, w) {
+    if (!Array.isArray(w) || !w.every((x) => typeof x === 'string')) {
+        throw antwortfehler(ort.name, `Antwort ist unbrauchbar (data.${ort.pfad}.${feld} ist keine Liste von Texten)`);
+    }
+    return [...w];
+}
+function merkmal(ort, w) {
+    const m = eintrag(ort, w);
+    return { key: kennung(ort, 'key', m.key), label: typeof m.label === 'string' ? m.label : '', values: textliste(ort, 'values', m.values) };
+}
+/**
+ * Vorgaben einer Gruppe: nur die Felder, die der Server sendet. Ein Preis als
+ * Bruchzahl ist kaputt (er fuellte sonst jede neue Variante falsch), ein Feld
+ * mit fremdem Typ ebenso.
+ */
+function vorgaben(ort, w) {
+    if (w === undefined || w === null)
+        return {};
+    const v = objekt(w);
+    const vOrt = { name: ort.name, pfad: `${ort.pfad}.defaults` };
+    if (!v)
+        throw antwortfehler(ort.name, `Antwort ist unbrauchbar (data.${vOrt.pfad} ist kein Objekt)`);
+    const raus = {};
+    if (v.unitPriceCents !== undefined && v.unitPriceCents !== null)
+        raus.unitPriceCents = ganzzahl(vOrt, 'unitPriceCents', v.unitPriceCents);
+    if (v.vatRate !== undefined && v.vatRate !== null) {
+        if (typeof v.vatRate !== 'number' || !Number.isFinite(v.vatRate))
+            throw antwortfehler(ort.name, `Antwort enthaelt keinen USt-Satz (data.${vOrt.pfad}.vatRate)`);
+        raus.vatRate = v.vatRate;
+    }
+    for (const feld of ['unit', 'groupId']) {
+        const t = v[feld];
+        if (t === undefined || t === null)
+            continue;
+        if (typeof t !== 'string')
+            throw antwortfehler(ort.name, `Antwort ist unbrauchbar (data.${vOrt.pfad}.${feld} ist kein Text)`);
+        raus[feld] = t;
+    }
+    if (v.stockTracked !== undefined && v.stockTracked !== null) {
+        if (typeof v.stockTracked !== 'boolean')
+            throw antwortfehler(ort.name, `Antwort ist unbrauchbar (data.${vOrt.pfad}.stockTracked ist kein Wahrheitswert)`);
+        raus.stockTracked = v.stockTracked;
+    }
+    return raus;
+}
+function mitglied(ort, w) {
+    const x = eintrag(ort, w);
+    return { articleId: kennung(ort, 'articleId', x.articleId), variantAttributes: textAbbildung(x.variantAttributes) ?? {} };
+}
+/**
+ * Eine Variantengruppe. `attributes` und `variants` sind zugesagte Listen:
+ * fehlen sie, ist die Antwort kaputt (eine leere Liste hiesse „keine Merkmale“
+ * bzw. „keine Varianten“).
+ */
+export function variantengruppe(ort, w) {
+    const g = eintrag(ort, w);
+    for (const feld of ['attributes', 'variants']) {
+        if (!Array.isArray(g[feld]))
+            throw antwortfehler(ort.name, `Antwort ist unbrauchbar (data.${ort.pfad}.${feld} ist keine Liste)`);
+    }
+    const unter = (feld, i) => ({ name: ort.name, pfad: `${ort.pfad}.${feld}[${i}]` });
+    return {
+        id: kennung(ort, 'id', g.id),
+        name: text(g.name),
+        attributes: g.attributes.map((m, i) => merkmal(unter('attributes', i), m)),
+        defaults: vorgaben(ort, g.defaults),
+        active: g.active !== false,
+        variants: g.variants.map((x, i) => mitglied(unter('variants', i), x)),
+        createdAt: text(g.createdAt),
+        updatedAt: text(g.updatedAt),
+    };
+}
 // ---- Listen ------------------------------------------------------------------
 /** Eine zugesagte Liste `data.<feld>`, Eintrag fuer Eintrag gelesen. */
 export function liste(name, daten, feld, lesen) {

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

@@ -23,9 +23,33 @@
  * **Wiederholen:** nach einem Zeitlimit oder Netzfehler denselben Aufruf mit
  * **demselben** `idempotencyKey` noch einmal senden. Er wirkt genau einmal und
  * liefert die gespeicherte Antwort; ein neuer Schluessel buchte ein zweites Mal.
+ * Darum meldet jeder schreibende Aufruf in diesen Faellen (auch HTTP 5xx und
+ * unlesbare Antwort) `outcome: 'unknown'`, nie `'rejected'`. Lesen und der
+ * Probelauf (`previewGoodsReceipt`) bleiben `'rejected'`.
  */
-import type { InternerTransport } from '../client/aufrufe.js';
+import type { ApiCall, InternerTransport } from '../client/aufrufe.js';
 import type { Article, ChangeStockConditionRequest, CreateArticleRequest, CreateReservationRequest, DeactivateArticleRequest, ExtendReservationRequest, GoodsReceiptPreview, GoodsReceiptPreviewRequest, ReceiveGoodsRequest, RecordStockLossRequest, ReleaseReservationRequest, Reservation, ReservationListQuery, ReservationPage, ReverseStockMovementRequest, StockOperation, TransferStockRequest, UpdateArticleRequest } from './typen.js';
+type Params = Record<string, unknown>;
+/** Die Anfrage als flache Kopie ohne `undefined`; der Aufrufer behaelt sein Objekt. Paketintern, auch fuer `varianten.ts`. */
+export declare function anfrage(name: ApiCall, request: unknown): Params;
+/**
+ * `idempotencyKey`: Text mit 1–120 Zeichen, nicht nur Leerraum. Er wird nie
+ * getrimmt oder gekuerzt: ein veraenderter Schluessel waere ein anderer.
+ */
+export declare function schluessel(name: ApiCall, p: Params, { pflicht }: {
+    pflicht: boolean;
+}): void;
+/** Eine Ganzzahl (Tausendstel, Cent, Mikro-Euro); fehlt sie, nur wenn sie darf. `null` nur, wo es leert. */
+export declare function ganz(name: ApiCall, feld: string, w: unknown, { pflicht, leerbar }?: {
+    pflicht?: boolean | undefined;
+    leerbar?: boolean | undefined;
+}): void;
+/**
+ * Zahlenfelder eines Artikels; `null` leert sie (bzw. heisst bei der Anlage
+ * „nicht angegeben“). `praefix` nennt die Stelle in der Anfrage (`variants[2].`).
+ */
+export declare function artikelZahlen(name: ApiCall, p: Params, praefix?: string): void;
+export declare const artikelAus: (name: ApiCall, daten: unknown) => Article;
 /**
  * Legt einen Artikel an. Mit `ean` ein Fremdartikel mit diesem Code (gueltige
  * Pruefziffer, frei im Konto), sonst vergibt der Server den naechsten eigenen
@@ -81,3 +105,4 @@ export declare function getReservation(transport: InternerTransport, reservation
 export declare function listReservations(transport: InternerTransport, query?: ReservationListQuery): Promise<ReservationPage>;
 /** Alle Reservierungen der Abfrage, Seite fuer Seite ueber `nextCursor`. */
 export declare function iterateReservations(transport: InternerTransport, query?: ReservationListQuery): AsyncGenerator<Reservation, void, undefined>;
+export {};

package/dist/esm/inventory/schreiben.js

@@ -23,13 +23,16 @@
  * **Wiederholen:** nach einem Zeitlimit oder Netzfehler denselben Aufruf mit
  * **demselben** `idempotencyKey` noch einmal senden. Er wirkt genau einmal und
  * liefert die gespeicherte Antwort; ein neuer Schluessel buchte ein zweites Mal.
+ * Darum meldet jeder schreibende Aufruf in diesen Faellen (auch HTTP 5xx und
+ * unlesbare Antwort) `outcome: 'unknown'`, nie `'rejected'`. Lesen und der
+ * Probelauf (`previewGoodsReceipt`) bleiben `'rejected'`.
  */
 import { abfrage, anfragefehler, kennung, seitenweise } from './endpunkte.js';
 import { artikel, liste, naechsterCursor, objekt, reservierung, vorgang, vorschauZeile } from './lesen.js';
 import { INVENTORY_IDEMPOTENCY_KEY_MAX, RESERVATION_MINUTES_MAX, RESERVATION_MINUTES_MIN } from './vertrag.js';
 // ---- Pruefung vor dem Senden ------------------------------------------------------
-/** Die Anfrage als flache Kopie ohne `undefined`; der Aufrufer behaelt sein Objekt. */
-function anfrage(name, request) {
+/** Die Anfrage als flache Kopie ohne `undefined`; der Aufrufer behaelt sein Objekt. Paketintern, auch fuer `varianten.ts`. */
+export function anfrage(name, request) {
     if (request === null || typeof request !== 'object' || Array.isArray(request)) {
         throw anfragefehler(name, 'Anfrage muss ein Objekt sein');
     }
@@ -43,7 +46,7 @@ function anfrage(name, request) {
  * `idempotencyKey`: Text mit 1–120 Zeichen, nicht nur Leerraum. Er wird nie
  * getrimmt oder gekuerzt: ein veraenderter Schluessel waere ein anderer.
  */
-function schluessel(name, p, { pflicht }) {
+export function schluessel(name, p, { pflicht }) {
     const w = p.idempotencyKey;
     if (w === undefined || w === null) {
         if (pflicht) {
@@ -58,7 +61,7 @@ function schluessel(name, p, { pflicht }) {
     }
 }
 /** Eine Ganzzahl (Tausendstel, Cent, Mikro-Euro); fehlt sie, nur wenn sie darf. `null` nur, wo es leert. */
-function ganz(name, feld, w, { pflicht = false, leerbar = false } = {}) {
+export function ganz(name, feld, w, { pflicht = false, leerbar = false } = {}) {
     if (w === undefined || (w === null && leerbar)) {
         if (pflicht)
             throw anfragefehler(name, `${feld} fehlt`);
@@ -104,19 +107,22 @@ function positionen(name, w, { pflicht, menge }, weiter = () => { }) {
     });
 }
 // ---- Artikel ------------------------------------------------------------------
-/** Zahlenfelder eines Artikels; `null` leert sie (bzw. heisst bei der Anlage „nicht angegeben“). */
-function artikelZahlen(name, p) {
+/**
+ * Zahlenfelder eines Artikels; `null` leert sie (bzw. heisst bei der Anlage
+ * „nicht angegeben“). `praefix` nennt die Stelle in der Anfrage (`variants[2].`).
+ */
+export function artikelZahlen(name, p, praefix = '') {
     for (const feld of ['unitPriceCents', 'minStock', 'purchasePriceMicros'])
-        ganz(name, feld, p[feld], { leerbar: true });
+        ganz(name, `${praefix}${feld}`, p[feld], { leerbar: true });
     const jeStandort = p.minStockByLocation;
     if (jeStandort === undefined || jeStandort === null)
         return;
     if (typeof jeStandort !== 'object' || Array.isArray(jeStandort))
-        throw anfragefehler(name, 'minStockByLocation muss ein Objekt { standort: Tausendstel } sein');
+        throw anfragefehler(name, `${praefix}minStockByLocation muss ein Objekt { standort: Tausendstel } sein`);
     for (const [standort, w] of Object.entries(jeStandort))
-        ganz(name, `minStockByLocation.${standort}`, w, { leerbar: true });
+        ganz(name, `${praefix}minStockByLocation.${standort}`, w, { leerbar: true });
 }
-const artikelAus = (name, daten) => artikel({ name, pfad: 'article' }, objekt(daten)?.article);
+export const artikelAus = (name, daten) => artikel({ name, pfad: 'article' }, objekt(daten)?.article);
 /**
  * Legt einen Artikel an. Mit `ean` ein Fremdartikel mit diesem Code (gueltige
  * Pruefziffer, frei im Konto), sonst vergibt der Server den naechsten eigenen
@@ -197,7 +203,9 @@ export async function previewGoodsReceipt(transport, request) {
         delete p.idempotencyKey;
     schluessel(name, p, { pflicht: false });
     eingangZahlen(name, p);
-    const daten = await transport(name, { ...p, dryRun: true });
+    // Ein Probelauf schreibt nichts: nach einem Zeitlimit bleibt er `rejected`,
+    // obwohl `receiveGoods` sonst Wirkung hat.
+    const daten = await transport(name, { ...p, dryRun: true }, undefined, undefined, { hasEffect: false });
     return { preview: liste(name, daten, 'preview', vorschauZeile) };
 }
 const stueckPositionen = (name, p) => positionen(name, p.items, { pflicht: true, menge: 'pflicht' });