@kreiseck/kasseneck-api 1.0.0-rc.2 → 1.0.0-rc.3

package/CHANGELOG.md

@@ -126,6 +126,27 @@ an upgrade as long as `/v1` is served.
   Reason: an app that read `'rejected'` could charge or refund a card twice;
   a silent resend below the package does the same without any error. Same
   change as in the Dart twin `kasseneck_api` (no `RetryClient`).
+- **Findings of the Dart twin (1.0.0-rc.3).** `listMyCashregisters` reads
+  the start receipt under `onboarding.start_receipt_created`/`_transmitted`
+  (`_at`) as `/v3` sends it; rc.1 and rc.2 read the internal
+  `startbeleg_*` names and reported every register as having no start
+  receipt (`CashregisterOnboardingPayload` changes accordingly). The fields
+  of `CashregisterOnboarding` are English now as well: `startbelegCreated`
+  is `startReceiptCreated`, `startbelegTransmitted` is
+  `startReceiptTransmitted`, `startbelegCreatedAt` is `startReceiptCreatedAt`,
+  `startbelegTransmittedAt` is `startReceiptTransmittedAt`; the German-name
+  guard no longer exempts `startbeleg`.
+  `sendReceiptEmail` reads its success reply leniently: without `to` it
+  returns the address you sent, without `at` it returns `at: null`
+  (`SendReceiptEmailResult.at` is `string | null`); throwing there would
+  invite a second email. `listMyPrinters` without `data.printers` and
+  `createPrintJob`/`getPrintJob` without `data.jobId` throw a
+  `KasseneckValidationError` (`scope: 'response'`) instead of returning an
+  empty list or an empty id: "no printer yet" must not look like a broken
+  reply, and a job without an id cannot be polled, so the cashier would print
+  again. `setMyRegisterDeviceSettings` takes `shortcuts` only as the whole map
+  of known actions (as `posSettingsChanges` produces it): the server checks
+  keys bound twice only within the map it receives.
 - **Strict validation before sending.** The 0.x payment fields
   (`paymentMethod`, `paymentMethodFromServer`, `creditCardProvider`,
   `cardPaymentId`, `cardPaymentData`) throw, also from plain JavaScript.
@@ -252,7 +273,7 @@ texts are English: `storno.ergebnis_unklar` is `cancellation.outcome_unknown`,
 `tax.intra_community_supply.title`. Every part is lower case with underscores,
 only country codes stay upper case (`country.AT`). Placeholders are English
 too: `{betrag}` is `{amount}`, `{grund}` is `{reason}`, `{sekunden}` is
-`{seconds}`, `{uid}` is `{vatId}`, and so on for 23 of 30 names; pass the
+`{seconds}`, `{uid}` is `{vatId}`, and so on for 25 of 30 names; pass the
 values under the new names (`messageText('checkout.locked', { reason })`). An
 old name throws as a missing value. `ERROR_RULES` entries use
 `kind`/`behavior`/`key` with the kinds `api`, `plain_text`, `timeout`,

package/README.md

@@ -615,10 +615,14 @@ const confirmation = await api.sendReceiptEmail({
   language: 'de',                        // optional; the backend currently only uses 'de'
 });
 confirmation.to;   // address as the backend logged it (trimmed, lower case)
-confirmation.at;   // time, ISO with Vienna offset
+confirmation.at;   // time, ISO with Vienna offset, or null
 confirmation.via;  // 'own' | 'platform' | 'platform_fallback' | null
 ```
 
+A success response means the email has gone out. If it lacks `to` or `at`,
+the call still succeeds: `to` falls back to the address you sent and `at` is
+`null`. Throwing there would invite sending the email a second time.
+
 The email contains a **link to the public receipt page**, not a PDF
 attachment: the receipt page uses the same line model as screen and printed
 receipt and offers a PDF there. The receipt itself stays untouched (BAO § 131,

package/dist/cjs/client/receipts.d.ts

@@ -315,10 +315,17 @@ export interface SendReceiptEmailOptions {
 }
 /** Was der Versand bestaetigt (Backend: beleg-mail-endpoints.js). */
 export interface SendReceiptEmailResult {
-    /** Adresse in der Form, in der das Backend sie protokolliert hat (getrimmt, klein). */
+    /**
+     * Adresse in der Form, in der das Backend sie protokolliert hat (getrimmt,
+     * klein). Nennt die Antwort keine, die gesendete (getrimmte) Adresse.
+     */
     to: string;
-    /** Zeitpunkt des Versands, ISO mit Wiener Zonenoffset (`2026-09-11T14:05:00+02:00`). */
-    at: string;
+    /**
+     * Zeitpunkt des Versands, ISO mit Wiener Zonenoffset
+     * (`2026-09-11T14:05:00+02:00`). `null`, wenn die Antwort keinen nennt: der
+     * Versand ist trotzdem bestaetigt.
+     */
+    at: string | null;
     /**
      * Versandweg: `own` (Postfach des Betriebs), `platform` oder
      * `platform_fallback` ([RECEIPT_EMAIL_VIAS]). `null`, wenn die Antwort ihn

package/dist/cjs/client/receipts.js

@@ -395,14 +395,17 @@ async function sendReceiptEmail(transport, options) {
     if (options.language !== undefined && options.language !== '')
         params.language = options.language;
     const daten = await transport('sendReceiptEmail', params);
-    if (typeof daten?.to !== 'string' || daten.to === '') {
-        throw antwortfehler('sendReceiptEmail', 'Antwort nennt keine Empfaengeradresse (data.to fehlt)');
-    }
-    if (typeof daten.at !== 'string' || daten.at === '') {
-        throw antwortfehler('sendReceiptEmail', 'Antwort nennt keinen Zeitpunkt (data.at fehlt)');
-    }
-    const via = index_js_2.RECEIPT_EMAIL_VIAS.includes(daten.via) ? daten.via : null;
-    return { to: daten.to, at: daten.at, via };
+    // Nachsichtig gelesen (wie der Dart-Zwilling): eine Erfolgsantwort heisst,
+    // die Mail ist schon verschickt. Ein Fehler wegen eines fehlenden
+    // Antwortfelds luede zum zweiten Versand ein; also zurueck, was da ist.
+    const gemeldet = daten?.to;
+    const zeit = daten?.at;
+    const via = index_js_2.RECEIPT_EMAIL_VIAS.includes(daten?.via) ? daten.via : null;
+    return {
+        to: typeof gemeldet === 'string' && gemeldet.trim() !== '' ? gemeldet : to,
+        at: typeof zeit === 'string' && zeit !== '' ? zeit : null,
+        via,
+    };
 }
 /**
  * Prueft die Gutschein-Kombination eines Belegs und liefert den ersten

package/dist/cjs/models/cashregister.d.ts

@@ -45,11 +45,11 @@ export interface Cashregister {
  */
 export interface CashregisterOnboarding {
     cashboxRegistered: boolean;
-    startbelegCreated: boolean;
-    startbelegTransmitted: boolean;
+    startReceiptCreated: boolean;
+    startReceiptTransmitted: boolean;
     cashboxRegisteredAt?: Date;
-    startbelegCreatedAt?: Date;
-    startbelegTransmittedAt?: Date;
+    startReceiptCreatedAt?: Date;
+    startReceiptTransmittedAt?: Date;
 }
 /** Nutzlast-Form, die dieses Paket liest — die Feldnamen von `listMyCashregisters`. */
 export interface CashregisterPayload {
@@ -61,13 +61,19 @@ export interface CashregisterPayload {
     token?: string | null;
     onboarding?: CashregisterOnboardingPayload | null;
 }
+/**
+ * `onboarding` am Draht `/v3` (fixtures/v3/antworten/kasse.json): der
+ * Startbeleg heisst dort `start_receipt_*`. Die inneren Namen
+ * `startbeleg_*` sendet nur `/v1`; wer sie hier laese, meldete jede Kasse
+ * als „Startbeleg fehlt“.
+ */
 export interface CashregisterOnboardingPayload {
     cashbox_registered?: boolean | null;
-    startbeleg_created?: boolean | null;
-    startbeleg_transmitted?: boolean | null;
+    start_receipt_created?: boolean | null;
+    start_receipt_transmitted?: boolean | null;
     cashbox_registered_at?: string | null;
-    startbeleg_created_at?: string | null;
-    startbeleg_transmitted_at?: string | null;
+    start_receipt_created_at?: string | null;
+    start_receipt_transmitted_at?: string | null;
 }
 /**
  * Liest eine Kasse aus der Antwort. `id` gewinnt aus der Nutzlast, faellt aber

package/dist/cjs/models/cashregister.js

@@ -18,11 +18,11 @@ function fromCashregisterPayload(payload, id) {
         ...(payload.signature_id ? { signatureId: payload.signature_id } : {}),
         onboarding: {
             cashboxRegistered: ob.cashbox_registered === true,
-            startbelegCreated: ob.startbeleg_created === true,
-            startbelegTransmitted: ob.startbeleg_transmitted === true,
+            startReceiptCreated: ob.start_receipt_created === true,
+            startReceiptTransmitted: ob.start_receipt_transmitted === true,
             ...zeitfeld('cashboxRegisteredAt', ob.cashbox_registered_at),
-            ...zeitfeld('startbelegCreatedAt', ob.startbeleg_created_at),
-            ...zeitfeld('startbelegTransmittedAt', ob.startbeleg_transmitted_at),
+            ...zeitfeld('startReceiptCreatedAt', ob.start_receipt_created_at),
+            ...zeitfeld('startReceiptTransmittedAt', ob.start_receipt_transmitted_at),
         },
     };
 }

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

@@ -11,7 +11,12 @@ export declare function posSettingsFromWire(data: {
 } | null | undefined): PosSettings;
 /** Betriebsweite Einstellungen schreiben (Recht `layout`); liefert den gemischten Stand. */
 export declare function setMyPosSettings(transport: InternerTransport, business: Partial<PosBusinessSettings>): Promise<PosBusinessSettings>;
-/** Geraete-Einstellungen schreiben (Recht `layout`); liefert den gemischten Stand. */
+/**
+ * Geraete-Einstellungen schreiben (Recht `layout`); liefert den gemischten
+ * Stand. `shortcuts` nur als ganze Karte aller bekannten Aktionen
+ * ([posSettingsChanges] liefert sie bei jeder Tastenaenderung), sonst wirft
+ * der Aufruf vor dem Senden.
+ */
 export declare function setMyRegisterDeviceSettings(transport: InternerTransport, deviceId: string, device: Partial<PosDeviceSettings>): Promise<PosDeviceSettings>;
 /** Eingabe von [setMyPosLogo]: ein Bild als Data-URL (PNG, JPEG, SVG) oder das Entfernen. */
 export type SetMyPosLogoOptions = {

package/dist/cjs/pos/client.js

@@ -57,7 +57,12 @@ async function setMyPosSettings(transport, business) {
     const daten = await transport(name, { business });
     return (0, settings_js_1.mergePosSettings)(settings_js_1.POS_BUSINESS_DEFAULTS, objekt(daten?.business));
 }
-/** Geraete-Einstellungen schreiben (Recht `layout`); liefert den gemischten Stand. */
+/**
+ * Geraete-Einstellungen schreiben (Recht `layout`); liefert den gemischten
+ * Stand. `shortcuts` nur als ganze Karte aller bekannten Aktionen
+ * ([posSettingsChanges] liefert sie bei jeder Tastenaenderung), sonst wirft
+ * der Aufruf vor dem Senden.
+ */
 async function setMyRegisterDeviceSettings(transport, deviceId, device) {
     const name = 'setMyRegisterDeviceSettings';
     if (typeof deviceId !== 'string' || deviceId.trim() === '') {
@@ -77,8 +82,15 @@ async function setMyRegisterDeviceSettings(transport, deviceId, device) {
                 throw new errors_js_1.KasseneckValidationError(name, `device.shortcuts.${aktion}: unbekannte Aktion`, 'request');
             }
         }
-        // Doppelbelegung innerhalb der gesendeten Karte; posSettingsChanges sendet
-        // bei jeder Tastenaenderung die ganze Karte, so ist das die ganze Belegung.
+        // Nur die ganze Karte: der Server prueft Doppelbelegungen nur in der
+        // gesendeten Karte, eine halbe (`{cash: ['Mod+K']}`) liesse eine
+        // Doppelbelegung mit einer gespeicherten Taste durch. posSettingsChanges
+        // liefert bei jeder Tastenaenderung die ganze Karte.
+        const fehlt = settings_js_1.POS_SHORTCUT_ACTIONS.filter((a) => karte[a] === undefined);
+        if (fehlt.length > 0) {
+            throw new errors_js_1.KasseneckValidationError(name, `device.shortcuts: ganze Karte senden (posSettingsChanges), es fehlen ${fehlt.join(', ')}`, 'request');
+        }
+        // Doppelbelegung in der ganzen Karte, also in der ganzen Belegung.
         const konflikt = (0, settings_js_1.posShortcutConflict)(karte);
         if (konflikt) {
             throw new errors_js_1.KasseneckValidationError(name, `device.shortcuts.${konflikt.action}: Taste ${konflikt.key} schon belegt (${konflikt.heldBy})`, 'request');

package/dist/cjs/pos/drucker.js

@@ -5,6 +5,7 @@ exports.isPrintJobFinished = isPrintJobFinished;
 exports.listMyPrinters = listMyPrinters;
 exports.createPrintJob = createPrintJob;
 exports.getPrintJob = getPrintJob;
+const errors_js_1 = require("../client/errors.js");
 const index_js_1 = require("../printing/index.js");
 /** Stand eines Druckjobs (Katalog `DRUCKJOB`). */
 exports.PRINT_JOB_STATUSES = ['pending', 'sent', 'printed', 'failed', 'expired'];
@@ -29,9 +30,27 @@ const STATUS = new Set(exports.PRINT_JOB_STATUSES);
 function status(v) {
     return typeof v === 'string' && STATUS.has(v) ? v : 'unknown';
 }
+/**
+ * Die Kennung eines Jobs aus der Antwort. Ohne sie kann niemand den Job
+ * abfragen; ein leerer Text waere ein angeblich angelegter Job, und der
+ * Kassier druckte ein zweites Mal.
+ */
+function jobKennung(name, d) {
+    const id = d?.jobId;
+    if (typeof id !== 'string' || id === '') {
+        throw new errors_js_1.KasseneckValidationError(name, 'Antwort enthaelt keine Kennung (data.jobId fehlt)', 'response');
+    }
+    return id;
+}
 async function listMyPrinters(transport) {
     const daten = await transport('listMyPrinters', {});
-    return (Array.isArray(daten?.printers) ? daten.printers : []).map((r) => {
+    const liste = daten?.printers;
+    if (!Array.isArray(liste)) {
+        // Keine Liste ist etwas anderes als eine leere Liste: „noch kein Drucker“
+        // darf nicht aussehen wie „Antwort kaputt“.
+        throw new errors_js_1.KasseneckValidationError('listMyPrinters', 'Antwort enthaelt keine Liste (data.printers fehlt)', 'response');
+    }
+    return liste.map((r) => {
         const d = (r ?? {});
         const e = d.lastResult && typeof d.lastResult === 'object' ? d.lastResult : null;
         return {
@@ -60,7 +79,7 @@ async function createPrintJob(transport, o) {
     if (o.brandMark === true)
         params.brand = true;
     const daten = await transport('createPrintJob', params);
-    return { jobId: String(daten?.jobId ?? ''), status: status(daten?.status), result: null };
+    return { jobId: jobKennung('createPrintJob', daten), status: status(daten?.status), result: null };
 }
 /**
  * Stand eines Druckjobs abfragen. Der Aufrufer fragt, bis [isPrintJobFinished]
@@ -71,7 +90,7 @@ async function getPrintJob(transport, o) {
     const d = await transport('getPrintJob', { printerId: o.printerId, jobId: o.jobId });
     const e = d?.result && typeof d.result === 'object' ? d.result : null;
     return {
-        jobId: String(d?.jobId ?? o.jobId), status: status(d?.status),
+        jobId: jobKennung('getPrintJob', d), status: status(d?.status),
         createdAt: zahl(d?.createdAt), sentAt: zahl(d?.sentAt),
         result: e ? { success: e.success === true, code: text(e.code), status: text(e.status), at: zahl(e.at) ?? undefined } : null,
     };

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.0.0-rc.2";
+export declare const PACKAGE_VERSION = "1.0.0-rc.3";

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.0.0-rc.2';
+exports.PACKAGE_VERSION = '1.0.0-rc.3';

package/dist/esm/client/receipts.d.ts

@@ -315,10 +315,17 @@ export interface SendReceiptEmailOptions {
 }
 /** Was der Versand bestaetigt (Backend: beleg-mail-endpoints.js). */
 export interface SendReceiptEmailResult {
-    /** Adresse in der Form, in der das Backend sie protokolliert hat (getrimmt, klein). */
+    /**
+     * Adresse in der Form, in der das Backend sie protokolliert hat (getrimmt,
+     * klein). Nennt die Antwort keine, die gesendete (getrimmte) Adresse.
+     */
     to: string;
-    /** Zeitpunkt des Versands, ISO mit Wiener Zonenoffset (`2026-09-11T14:05:00+02:00`). */
-    at: string;
+    /**
+     * Zeitpunkt des Versands, ISO mit Wiener Zonenoffset
+     * (`2026-09-11T14:05:00+02:00`). `null`, wenn die Antwort keinen nennt: der
+     * Versand ist trotzdem bestaetigt.
+     */
+    at: string | null;
     /**
      * Versandweg: `own` (Postfach des Betriebs), `platform` oder
      * `platform_fallback` ([RECEIPT_EMAIL_VIAS]). `null`, wenn die Antwort ihn

package/dist/esm/client/receipts.js

@@ -376,14 +376,17 @@ export async function sendReceiptEmail(transport, options) {
     if (options.language !== undefined && options.language !== '')
         params.language = options.language;
     const daten = await transport('sendReceiptEmail', params);
-    if (typeof daten?.to !== 'string' || daten.to === '') {
-        throw antwortfehler('sendReceiptEmail', 'Antwort nennt keine Empfaengeradresse (data.to fehlt)');
-    }
-    if (typeof daten.at !== 'string' || daten.at === '') {
-        throw antwortfehler('sendReceiptEmail', 'Antwort nennt keinen Zeitpunkt (data.at fehlt)');
-    }
-    const via = RECEIPT_EMAIL_VIAS.includes(daten.via) ? daten.via : null;
-    return { to: daten.to, at: daten.at, via };
+    // Nachsichtig gelesen (wie der Dart-Zwilling): eine Erfolgsantwort heisst,
+    // die Mail ist schon verschickt. Ein Fehler wegen eines fehlenden
+    // Antwortfelds luede zum zweiten Versand ein; also zurueck, was da ist.
+    const gemeldet = daten?.to;
+    const zeit = daten?.at;
+    const via = RECEIPT_EMAIL_VIAS.includes(daten?.via) ? daten.via : null;
+    return {
+        to: typeof gemeldet === 'string' && gemeldet.trim() !== '' ? gemeldet : to,
+        at: typeof zeit === 'string' && zeit !== '' ? zeit : null,
+        via,
+    };
 }
 /**
  * Prueft die Gutschein-Kombination eines Belegs und liefert den ersten

package/dist/esm/models/cashregister.d.ts

@@ -45,11 +45,11 @@ export interface Cashregister {
  */
 export interface CashregisterOnboarding {
     cashboxRegistered: boolean;
-    startbelegCreated: boolean;
-    startbelegTransmitted: boolean;
+    startReceiptCreated: boolean;
+    startReceiptTransmitted: boolean;
     cashboxRegisteredAt?: Date;
-    startbelegCreatedAt?: Date;
-    startbelegTransmittedAt?: Date;
+    startReceiptCreatedAt?: Date;
+    startReceiptTransmittedAt?: Date;
 }
 /** Nutzlast-Form, die dieses Paket liest — die Feldnamen von `listMyCashregisters`. */
 export interface CashregisterPayload {
@@ -61,13 +61,19 @@ export interface CashregisterPayload {
     token?: string | null;
     onboarding?: CashregisterOnboardingPayload | null;
 }
+/**
+ * `onboarding` am Draht `/v3` (fixtures/v3/antworten/kasse.json): der
+ * Startbeleg heisst dort `start_receipt_*`. Die inneren Namen
+ * `startbeleg_*` sendet nur `/v1`; wer sie hier laese, meldete jede Kasse
+ * als „Startbeleg fehlt“.
+ */
 export interface CashregisterOnboardingPayload {
     cashbox_registered?: boolean | null;
-    startbeleg_created?: boolean | null;
-    startbeleg_transmitted?: boolean | null;
+    start_receipt_created?: boolean | null;
+    start_receipt_transmitted?: boolean | null;
     cashbox_registered_at?: string | null;
-    startbeleg_created_at?: string | null;
-    startbeleg_transmitted_at?: string | null;
+    start_receipt_created_at?: string | null;
+    start_receipt_transmitted_at?: string | null;
 }
 /**
  * Liest eine Kasse aus der Antwort. `id` gewinnt aus der Nutzlast, faellt aber

package/dist/esm/models/cashregister.js

@@ -15,11 +15,11 @@ export function fromCashregisterPayload(payload, id) {
         ...(payload.signature_id ? { signatureId: payload.signature_id } : {}),
         onboarding: {
             cashboxRegistered: ob.cashbox_registered === true,
-            startbelegCreated: ob.startbeleg_created === true,
-            startbelegTransmitted: ob.startbeleg_transmitted === true,
+            startReceiptCreated: ob.start_receipt_created === true,
+            startReceiptTransmitted: ob.start_receipt_transmitted === true,
             ...zeitfeld('cashboxRegisteredAt', ob.cashbox_registered_at),
-            ...zeitfeld('startbelegCreatedAt', ob.startbeleg_created_at),
-            ...zeitfeld('startbelegTransmittedAt', ob.startbeleg_transmitted_at),
+            ...zeitfeld('startReceiptCreatedAt', ob.start_receipt_created_at),
+            ...zeitfeld('startReceiptTransmittedAt', ob.start_receipt_transmitted_at),
         },
     };
 }

package/dist/esm/pos/client.d.ts

@@ -11,7 +11,12 @@ export declare function posSettingsFromWire(data: {
 } | null | undefined): PosSettings;
 /** Betriebsweite Einstellungen schreiben (Recht `layout`); liefert den gemischten Stand. */
 export declare function setMyPosSettings(transport: InternerTransport, business: Partial<PosBusinessSettings>): Promise<PosBusinessSettings>;
-/** Geraete-Einstellungen schreiben (Recht `layout`); liefert den gemischten Stand. */
+/**
+ * Geraete-Einstellungen schreiben (Recht `layout`); liefert den gemischten
+ * Stand. `shortcuts` nur als ganze Karte aller bekannten Aktionen
+ * ([posSettingsChanges] liefert sie bei jeder Tastenaenderung), sonst wirft
+ * der Aufruf vor dem Senden.
+ */
 export declare function setMyRegisterDeviceSettings(transport: InternerTransport, deviceId: string, device: Partial<PosDeviceSettings>): Promise<PosDeviceSettings>;
 /** Eingabe von [setMyPosLogo]: ein Bild als Data-URL (PNG, JPEG, SVG) oder das Entfernen. */
 export type SetMyPosLogoOptions = {

package/dist/esm/pos/client.js

@@ -50,7 +50,12 @@ export async function setMyPosSettings(transport, business) {
     const daten = await transport(name, { business });
     return mergePosSettings(POS_BUSINESS_DEFAULTS, objekt(daten?.business));
 }
-/** Geraete-Einstellungen schreiben (Recht `layout`); liefert den gemischten Stand. */
+/**
+ * Geraete-Einstellungen schreiben (Recht `layout`); liefert den gemischten
+ * Stand. `shortcuts` nur als ganze Karte aller bekannten Aktionen
+ * ([posSettingsChanges] liefert sie bei jeder Tastenaenderung), sonst wirft
+ * der Aufruf vor dem Senden.
+ */
 export async function setMyRegisterDeviceSettings(transport, deviceId, device) {
     const name = 'setMyRegisterDeviceSettings';
     if (typeof deviceId !== 'string' || deviceId.trim() === '') {
@@ -70,8 +75,15 @@ export async function setMyRegisterDeviceSettings(transport, deviceId, device) {
                 throw new KasseneckValidationError(name, `device.shortcuts.${aktion}: unbekannte Aktion`, 'request');
             }
         }
-        // Doppelbelegung innerhalb der gesendeten Karte; posSettingsChanges sendet
-        // bei jeder Tastenaenderung die ganze Karte, so ist das die ganze Belegung.
+        // Nur die ganze Karte: der Server prueft Doppelbelegungen nur in der
+        // gesendeten Karte, eine halbe (`{cash: ['Mod+K']}`) liesse eine
+        // Doppelbelegung mit einer gespeicherten Taste durch. posSettingsChanges
+        // liefert bei jeder Tastenaenderung die ganze Karte.
+        const fehlt = POS_SHORTCUT_ACTIONS.filter((a) => karte[a] === undefined);
+        if (fehlt.length > 0) {
+            throw new KasseneckValidationError(name, `device.shortcuts: ganze Karte senden (posSettingsChanges), es fehlen ${fehlt.join(', ')}`, 'request');
+        }
+        // Doppelbelegung in der ganzen Karte, also in der ganzen Belegung.
         const konflikt = posShortcutConflict(karte);
         if (konflikt) {
             throw new KasseneckValidationError(name, `device.shortcuts.${konflikt.action}: Taste ${konflikt.key} schon belegt (${konflikt.heldBy})`, 'request');

package/dist/esm/pos/drucker.js

@@ -1,3 +1,4 @@
+import { KasseneckValidationError } from '../client/errors.js';
 import { rasterRowsBase64 } from '../printing/index.js';
 /** Stand eines Druckjobs (Katalog `DRUCKJOB`). */
 export const PRINT_JOB_STATUSES = ['pending', 'sent', 'printed', 'failed', 'expired'];
@@ -22,9 +23,27 @@ const STATUS = new Set(PRINT_JOB_STATUSES);
 function status(v) {
     return typeof v === 'string' && STATUS.has(v) ? v : 'unknown';
 }
+/**
+ * Die Kennung eines Jobs aus der Antwort. Ohne sie kann niemand den Job
+ * abfragen; ein leerer Text waere ein angeblich angelegter Job, und der
+ * Kassier druckte ein zweites Mal.
+ */
+function jobKennung(name, d) {
+    const id = d?.jobId;
+    if (typeof id !== 'string' || id === '') {
+        throw new KasseneckValidationError(name, 'Antwort enthaelt keine Kennung (data.jobId fehlt)', 'response');
+    }
+    return id;
+}
 export async function listMyPrinters(transport) {
     const daten = await transport('listMyPrinters', {});
-    return (Array.isArray(daten?.printers) ? daten.printers : []).map((r) => {
+    const liste = daten?.printers;
+    if (!Array.isArray(liste)) {
+        // Keine Liste ist etwas anderes als eine leere Liste: „noch kein Drucker“
+        // darf nicht aussehen wie „Antwort kaputt“.
+        throw new KasseneckValidationError('listMyPrinters', 'Antwort enthaelt keine Liste (data.printers fehlt)', 'response');
+    }
+    return liste.map((r) => {
         const d = (r ?? {});
         const e = d.lastResult && typeof d.lastResult === 'object' ? d.lastResult : null;
         return {
@@ -53,7 +72,7 @@ export async function createPrintJob(transport, o) {
     if (o.brandMark === true)
         params.brand = true;
     const daten = await transport('createPrintJob', params);
-    return { jobId: String(daten?.jobId ?? ''), status: status(daten?.status), result: null };
+    return { jobId: jobKennung('createPrintJob', daten), status: status(daten?.status), result: null };
 }
 /**
  * Stand eines Druckjobs abfragen. Der Aufrufer fragt, bis [isPrintJobFinished]
@@ -64,7 +83,7 @@ export async function getPrintJob(transport, o) {
     const d = await transport('getPrintJob', { printerId: o.printerId, jobId: o.jobId });
     const e = d?.result && typeof d.result === 'object' ? d.result : null;
     return {
-        jobId: String(d?.jobId ?? o.jobId), status: status(d?.status),
+        jobId: jobKennung('getPrintJob', d), status: status(d?.status),
         createdAt: zahl(d?.createdAt), sentAt: zahl(d?.sentAt),
         result: e ? { success: e.success === true, code: text(e.code), status: text(e.status), at: zahl(e.at) ?? undefined } : null,
     };

package/dist/esm/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.0.0-rc.2";
+export declare const PACKAGE_VERSION = "1.0.0-rc.3";

package/dist/esm/version.js

@@ -4,4 +4,4 @@
  * Client-Version, Nachtrag §6). Ein Test haelt sie gleich mit `package.json`;
  * beim Anheben der Version beide Stellen aendern.
  */
-export const PACKAGE_VERSION = '1.0.0-rc.2';
+export const PACKAGE_VERSION = '1.0.0-rc.3';

package/fixtures/hobex-hps-codes.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.0-rc.2",
+  "version": "1.0.0-rc.3",
   "measuredOn": {
     "tid": "3600335",
     "hpsVersion": "1.10.0",

package/fixtures/invoice-api.schema.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "Kasseneck Rechnungs-API",
   "version": 2,
-  "package": "1.0.0-rc.2",
+  "package": "1.0.0-rc.3",
   "endpoints": {
     "createCustomer": {
       "request": {

package/fixtures/invoice-texts.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.0-rc.2",
+  "version": "1.0.0-rc.3",
   "languages": [
     "de",
     "en"

package/fixtures/pos-texts.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.0-rc.2",
+  "version": "1.0.0-rc.3",
   "messages": {
     "network.no_connection": {
       "text": "Keine Verbindung zum Server. Bitte die Internetverbindung prüfen und erneut versuchen."

package/fixtures/surface.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.0-rc.2",
+  "version": "1.0.0-rc.3",
   "baseUrls": {
     "public": "https://api.kasseneck.at/v3",
     "pos": "https://kasse.kasseneck.at/api/v3"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kreiseck/kasseneck-api",
-  "version": "1.0.0-rc.2",
+  "version": "1.0.0-rc.3",
   "description": "Austrian fiscal cash register (RKSV) client for JavaScript and TypeScript: signed receipts, cancellations, card payments, receipt printing (ESC/POS), invoices. RKSV-Registrierkasse für JavaScript und TypeScript.",
   "license": "Apache-2.0",
   "author": "Kreiseck",