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

package/dist/cjs/register/pairing.d.ts

@@ -1,10 +1,11 @@
 import { type TransportOptions } from '../client/transport.js';
 import { type ReceiptCompany } from '../models/receipt-company.js';
-import { type KasseSettings } from '../kasse/settings.js';
+import type { PosSettings } from '../pos/settings.js';
 /**
  * Verbindungsangaben ohne Anmeldung — alles, was [TransportOptions] ausser der
- * Anmeldung fuehrt. Alle Felder sind wahlfrei: ohne Angabe gelten Basis-URL und
- * Zeitlimit der Produktion und das globale `fetch`.
+ * Anmeldung fuehrt. Alle Felder sind wahlfrei: ohne Angabe gelten der Kassenweg
+ * der Produktion ([POS_BASE_URL]), das Zeitlimit der Produktion und das
+ * globale `fetch`. Die Web-Kasse gibt `posBaseUrl: '/api/v3'` (gleicher Ursprung).
  */
 export type RegisterDeviceConnection = Omit<TransportOptions, 'auth'>;
 /** Ausweis eines gekoppelten Geraets — Nachweis der beiden Folgeaufrufe. */
@@ -44,11 +45,11 @@ export interface RegisterGeo {
     acc?: number;
 }
 /** Angaben, die Kopplung und Login zusaetzlich mitschicken duerfen. */
-export interface RegisterGeraeteAngaben {
+export interface RegisterDeviceInfo {
     client?: RegisterClientInfo;
     geo?: RegisterGeo | null;
 }
-export interface PairRegisterDeviceOptions extends RegisterDeviceConnection, RegisterGeraeteAngaben {
+export interface PairRegisterDeviceOptions extends RegisterDeviceConnection, RegisterDeviceInfo {
     /**
      * Die Kasse ist schon auf einem anderen Geraet geoeffnet (BELEGT-Rueckfrage):
      * `true` uebernimmt sie hierher und widerruft das alte Geraet.
@@ -67,14 +68,25 @@ export interface PairRegisterDeviceOptions extends RegisterDeviceConnection, Reg
     /** Bezeichnung dieses Geraets in der Geraeteliste; ohne Angabe "Kasse". */
     label?: string;
 }
-/** Ergebnis der Kopplung — der vollstaendige Ausweis dieses Geraets. */
+/**
+ * Ergebnis der Kopplung: der vollstaendige Ausweis dieses Geraets.
+ *
+ * **Speicherformat der App bleibt, wie es ist** (Nachtrag §9, B2): wer den
+ * Ausweis ablegt, bildet `companyName`/`cashregisterLabel` auf seine
+ * bisherigen Felder ab (Web-Kasse: `betrieb`/`kasse`). Die Aufrufe dieses
+ * Pakets lesen aus einem abgelegten Satz nur `ownerUid`, `deviceId`,
+ * `deviceSecret` (und `cashregisterId` beim Login); weitere Felder eines alten
+ * Satzes stoeren nicht.
+ */
 export interface PairedRegisterDevice extends RegisterDeviceCredentials {
     /** Kasse, an die die Kopplung dieses Geraet gebunden hat. */
     cashregisterId: string;
-    /** Firmenname des Betriebs (Backend: `betrieb`) — Anzeige, kann leer sein. */
+    /** Firmenname des Betriebs; Anzeige, kann leer sein. */
     companyName: string;
-    /** Bezeichnung der Kasse (Backend: `kasse`) — Anzeige, kann leer sein. */
+    /** Bezeichnung der Kasse (ohne Bezeichnung die Kassen-ID); Anzeige, kann leer sein. */
     cashregisterLabel: string;
+    /** Die Kopplung gilt der Test-Umgebung des Betriebs (`kr_test_`-Konto). */
+    testEnvironment: boolean;
 }
 /**
  * Art eines Kassen-Benutzers: eine Person oder ein Geraet (Sammelkonto). Ein
@@ -93,25 +105,25 @@ export interface RegisterUserSummary {
      * Betriebs gesetzt: die Kasse zeigt ihm das Freifeld statt der Kaestchen.
      * Das Backend sendet das Feld nur, wenn es zutrifft; gelesen ist es immer da.
      */
-    altbestand: boolean;
+    pinPolicyOutdated: boolean;
 }
-/** PIN-Regel des Betriebs — daraus baut die Kasse Kaestchen und Tastatur. */
+/** PIN-Regel des Betriebs: daraus baut die Kasse Kaestchen und Tastatur. */
 export interface RegisterPinPolicy {
     /** Feste Stellenzahl (Backend: 3 bis 6). */
-    stellen: number;
-    /** `ziffern` (nur 0-9) oder `zeichen` (0-9 plus Kopplungs-Alphabet). */
-    zeichen: 'ziffern' | 'zeichen' | (string & {});
+    length: number;
+    /** `digits` (nur 0-9) oder `alphanumeric` (0-9 plus Kopplungs-Alphabet). */
+    charset: 'digits' | 'alphanumeric' | (string & {});
 }
-/** Anmeldemodus des Geraets; ein unbekannter kuenftiger Wert kommt durch. */
-export type RegisterLoginMode = 'auswahl' | 'pin' | (string & {});
+/** Anmeldemodus des Geraets: Benutzerauswahl oder nur PIN. */
+export type RegisterLoginMode = 'select_user' | 'pin';
 /** Antwort von [listRegisterUsersForDevice]: Benutzer, Regel, Modus. */
 export interface RegisterDeviceUsers {
     /** Im Modus `pin` bewusst leer — Namen haben am nur-PIN-Geraet nichts verloren. */
     users: RegisterUserSummary[];
     /** Kassen-Einstellungen (betriebsweit + Geraet), gemischt mit den Standardwerten. */
-    settings: KasseSettings;
-    /** Belegkopf-Daten des Betriebs (Name, Anschrift, UID, Fusszeilen) -- ohne Geheimnisse. */
-    betriebsdaten: ReceiptCompany | null;
+    settings: PosSettings;
+    /** Belegkopf-Daten des Betriebs (Name, Anschrift, UID, Fusszeilen), ohne Geheimnisse. */
+    receiptHeader: ReceiptCompany | null;
     /**
      * `null`, wenn das Backend (noch) keine Regel nennt — dann zeigt die Kasse
      * das Freifeld, statt Kaestchen mit einer erratenen Stellenzahl.
@@ -119,17 +131,19 @@ export interface RegisterDeviceUsers {
     policy: RegisterPinPolicy | null;
     loginMode: RegisterLoginMode;
     /** Der Betrieb verlangt die Ortung beim Login (Standortsperre an). */
-    standortsperre: boolean;
+    locationLock: boolean;
     /**
-     * Darf die gebundene Kasse ueberhaupt Belege erstellen? `bereit: false`
-     * nennt den Grund (ausser Betrieb, Schlussbeleg erstellt) — die Kasse
-     * sperrt das Kassieren VOR dem ersten Beleg statt an createReceipt zu
-     * scheitern. Fehlt das Feld (aelteres Backend), gilt bereit.
+     * Darf die gebundene Kasse ueberhaupt Belege erstellen? `ready: false`
+     * nennt den Grund als Menschentext (ausser Betrieb, keine Signaturkarte,
+     * Startbeleg fehlt): die Kasse sperrt das Kassieren VOR dem ersten Beleg
+     * statt an createReceipt zu scheitern. Fehlt das Feld, gilt bereit.
      */
-    kasse?: {
-        bereit: boolean;
-        grund?: string | null;
-    } | null;
+    cashregister?: {
+        ready: boolean;
+        reason?: string | null;
+    };
+    /** Das Geraet haengt an der Test-Umgebung des Betriebs. */
+    testEnvironment: boolean;
 }
 /**
  * Rechte eines Kassen-Benutzers (Backend: `perms`, Vorlagen `PERMS_KASSIER`
@@ -169,7 +183,7 @@ export interface RegisterUserPerms {
 }
 /**
  * Alle Rechte-Schluessel, die dieses Paket kennt — die Zwillinge pruefen
- * dagegen, und ueber `fixtures/oberflaeche.json` steht die Liste im Vertrag.
+ * dagegen, und ueber `fixtures/surface.json` steht die Liste im Vertrag.
  *
  * `satisfies` schliesst die eine Richtung: ein Name, den [RegisterUserPerms]
  * nicht fuehrt (Tippfehler, umbenanntes Recht), kommt hier nicht durch.
@@ -205,7 +219,7 @@ export interface RegisterUserSession {
 }
 export interface ListRegisterUsersForDeviceOptions extends RegisterDeviceConnection, RegisterDeviceCredentials {
 }
-export interface RegisterUserLoginOptions extends RegisterDeviceConnection, RegisterDeviceCredentials, RegisterGeraeteAngaben {
+export interface RegisterUserLoginOptions extends RegisterDeviceConnection, RegisterDeviceCredentials, RegisterDeviceInfo {
     /** Kassen-Benutzer aus [listRegisterUsersForDevice]. */
     userId: string;
     /**
@@ -219,7 +233,8 @@ export interface RegisterUserLoginOptions extends RegisterDeviceConnection, Regi
     /**
      * Eine belegte Kasse uebernehmen. Nur mit dem Recht `takeover` (Kassen-Chef);
      * die aelteste laufende Sitzung wird dabei verdraengt. Ohne das Recht bleibt
-     * es bei der Abweisung "Kasse wird gerade auf … verwendet".
+     * es bei der Abweisung `cashregister_in_use` (Daten `deviceLabel`,
+     * `takeoverAllowed: false`, siehe [registerErrorDetails]).
      */
     takeover?: boolean;
     /**
@@ -232,7 +247,7 @@ export interface RegisterUserLoginOptions extends RegisterDeviceConnection, Regi
      */
     takeoverSessionId?: string;
 }
-export interface RegisterPinLoginOptions extends RegisterDeviceConnection, RegisterDeviceCredentials, RegisterGeraeteAngaben {
+export interface RegisterPinLoginOptions extends RegisterDeviceConnection, RegisterDeviceCredentials, RegisterDeviceInfo {
     /**
      * Die PIN allein — sie identifiziert UND authentifiziert (Geraete-Modus
      * `pin`; das Backend haelt PINs je Betrieb eindeutig). Das Format prueft
@@ -275,12 +290,16 @@ export declare function unpairRegisterDevice(options: ListRegisterUsersForDevice
 export interface RegisterSession {
     id: string;
     deviceId: string | null;
-    /** Name des Geraets; „Kasse", wenn keiner gesetzt wurde. */
-    deviceLabel: string;
+    /**
+     * Name des Geraets; `null`, wenn es keinen hat (unter `/v3` sendet das
+     * Backend dann `null` statt des frueheren Ersatzes „Kasse"). Die Oberflaeche
+     * waehlt ihren eigenen Ersatztext.
+     */
+    deviceLabel: string | null;
     startedAt: number | null;
     expiresAt: number | null;
     /** Laeuft diese Sitzung auf DIESEM Geraet? */
-    selbst: boolean;
+    own: boolean;
     /**
      * Wer angemeldet ist. Fehlt an einem nur-PIN-Geraet: Dort zeigt schon die
      * Benutzerliste keine Namen, und was dort nicht steht, darf hier nicht
@@ -290,7 +309,7 @@ export interface RegisterSession {
     userName?: string;
 }
 /** Was eine Kasse gerade haelt -- Lizenzzahl und laufende Sitzungen. */
-export interface RegisterSessionsStand {
+export interface RegisterSessionOverview {
     /** Wie viele Sitzungen gleichzeitig laufen duerfen. */
     licenses: number;
     /** Aelteste zuerst: oben steht, was das Backend ohne Wahl verdraengen wuerde. */
@@ -310,7 +329,7 @@ export interface ListRegisterSessionsForDeviceOptions extends RegisterDeviceConn
  * [listRegisterUsersForDevice]: An diesem Punkt gibt es weder Sitzung noch
  * Token. Die Kasse bestimmt das Backend aus dem Geraet, nicht aus dem Aufruf.
  */
-export declare function listRegisterSessionsForDevice(options: ListRegisterSessionsForDeviceOptions): Promise<RegisterSessionsStand>;
+export declare function listRegisterSessionsForDevice(options: ListRegisterSessionsForDeviceOptions): Promise<RegisterSessionOverview>;
 export declare function listRegisterUsersForDevice(options: ListRegisterUsersForDeviceOptions): Promise<RegisterDeviceUsers>;
 /**
  * Kassen-Benutzer per PIN anmelden. **Ohne Anmeldung** — dieser Aufruf

package/dist/cjs/register/pairing.js

@@ -12,7 +12,7 @@ exports.registerPinLogin = registerPinLogin;
 const errors_js_1 = require("../client/errors.js");
 const transport_js_1 = require("../client/transport.js");
 const receipt_company_js_1 = require("../models/receipt-company.js");
-const settings_js_1 = require("../kasse/settings.js");
+const client_js_1 = require("../pos/client.js");
 /**
  * Die drei Aufrufe, die **ohne jede Identitaet** laufen: Kopplung eines
  * Geraets, Benutzerliste dieses Geraets, PIN-Anmeldung. Sie sind der Weg, auf
@@ -51,7 +51,7 @@ const settings_js_1 = require("../kasse/settings.js");
 const ohneAnmeldung = () => ({ headers: {}, params: {} });
 /**
  * Alle Rechte-Schluessel, die dieses Paket kennt — die Zwillinge pruefen
- * dagegen, und ueber `fixtures/oberflaeche.json` steht die Liste im Vertrag.
+ * dagegen, und ueber `fixtures/surface.json` steht die Liste im Vertrag.
  *
  * `satisfies` schliesst die eine Richtung: ein Name, den [RegisterUserPerms]
  * nicht fuehrt (Tippfehler, umbenanntes Recht), kommt hier nicht durch.
@@ -94,8 +94,9 @@ async function pairRegisterDevice(options) {
         deviceSecret: pflichtfeld('pairRegisterDevice', daten, 'deviceSecret'),
         ownerUid: pflichtfeld('pairRegisterDevice', daten, 'ownerUid'),
         cashregisterId: pflichtfeld('pairRegisterDevice', daten, 'cashregisterId'),
-        companyName: text(daten?.['betrieb']),
-        cashregisterLabel: text(daten?.['kasse']),
+        companyName: text(daten?.['companyName']),
+        cashregisterLabel: text(daten?.['cashregisterLabel']),
+        testEnvironment: daten?.['testEnvironment'] === true,
     };
 }
 /**
@@ -150,10 +151,10 @@ async function listRegisterSessionsForDevice(options) {
             // nichts tun kann, ist schlimmer als keine.
             id: pflichtfeld(name, roh, 'id'),
             deviceId: typeof roh['deviceId'] === 'string' && roh['deviceId'] ? roh['deviceId'] : null,
-            deviceLabel: text(roh['deviceLabel']) || 'Kasse',
+            deviceLabel: text(roh['deviceLabel']) || null,
             startedAt: typeof roh['startedAt'] === 'number' ? roh['startedAt'] : null,
             expiresAt: typeof roh['expiresAt'] === 'number' ? roh['expiresAt'] : null,
-            selbst: roh['selbst'] === true,
+            own: roh['own'] === true,
             // Nur uebernehmen, wenn wirklich einer kam: ein leerer String stuende
             // in der Oberflaeche als namenlose Zeile, statt die Spalte wegzulassen.
             ...(typeof roh['userName'] === 'string' && roh['userName'] ? { userName: roh['userName'] } : {}),
@@ -181,49 +182,48 @@ async function listRegisterUsersForDevice(options) {
             id: pflichtfeld(name, roh, 'id'),
             name: text(roh['name']),
             kind: typeof roh['kind'] === 'string' && roh['kind'] ? roh['kind'] : 'person',
-            altbestand: roh['altbestand'] === true,
+            pinPolicyOutdated: roh['pinPolicyOutdated'] === true,
         };
     });
-    const settingsRoh = (daten?.settings ?? {});
-    const settings = {
-        betrieb: (0, settings_js_1.mergeKasseSettings)(settings_js_1.KASSE_BETRIEB_STANDARD, (settingsRoh.betrieb ?? null)),
-        geraet: (0, settings_js_1.mergeKasseSettings)(settings_js_1.KASSE_GERAET_STANDARD, (settingsRoh.geraet ?? null)),
-    };
-    const bd = daten?.betriebsdaten;
-    const betriebsdaten = bd && typeof bd === 'object' ? (0, receipt_company_js_1.fromReceiptCompanyPayload)(bd) : null;
+    const settingsRoh = daten?.settings;
+    const settings = (0, client_js_1.posSettingsFromWire)(settingsRoh !== null && typeof settingsRoh === 'object' ? settingsRoh : null);
+    const kopf = daten?.receiptHeader;
+    const receiptHeader = kopf && typeof kopf === 'object' ? (0, receipt_company_js_1.fromReceiptCompanyPayload)(kopf) : null;
     return {
         users,
         policy: regel(daten?.policy),
-        loginMode: daten?.loginMode === 'pin' ? 'pin' : 'auswahl',
+        // Nur `pin` heisst nur-PIN; alles andere (auch ein kuenftiger Wert) zeigt
+        // die Auswahl: die Namen stehen dann in `users`, und das Backend weist
+        // eine Anmeldung ohne Auswahl ohnehin mit `login_mode_select_user` ab.
+        loginMode: daten?.loginMode === 'pin' ? 'pin' : 'select_user',
         settings,
-        betriebsdaten,
-        standortsperre: daten?.standortsperre === true,
-        // 0.6.27 ergaenzte nur den TYP — hier fiel das Feld beim Zusammenbau
-        // stumm weg, und die Kasse sah nie eine Sperre. Fehlt es (aelteres
-        // Backend), bleibt es undefined: dann gilt bereit.
-        kasse: kasseBereit(daten?.kasse),
+        receiptHeader,
+        locationLock: daten?.locationLock === true,
+        // Fehlt das Feld, bleibt es undefined: dann gilt bereit.
+        ...(kasseBereit(daten?.cashregister) ? { cashregister: kasseBereit(daten?.cashregister) } : {}),
+        testEnvironment: daten?.testEnvironment === true,
     };
 }
 function kasseBereit(wert) {
     if (typeof wert !== 'object' || wert === null || Array.isArray(wert))
         return undefined;
     const roh = wert;
-    if (typeof roh['bereit'] !== 'boolean')
+    if (typeof roh['ready'] !== 'boolean')
         return undefined;
-    return { bereit: roh['bereit'], grund: typeof roh['grund'] === 'string' ? roh['grund'] : null };
+    return { ready: roh['ready'], reason: typeof roh['reason'] === 'string' ? roh['reason'] : null };
 }
 /** Die Regel aus der Antwort — oder `null`, wenn keine brauchbare kommt. */
 function regel(wert) {
     if (typeof wert !== 'object' || wert === null || Array.isArray(wert))
         return null;
     const roh = wert;
-    const stellen = roh['stellen'];
-    const zeichen = roh['zeichen'];
-    if (typeof stellen !== 'number' || !Number.isInteger(stellen) || stellen < 1)
+    const length = roh['length'];
+    const charset = roh['charset'];
+    if (typeof length !== 'number' || !Number.isInteger(length) || length < 1)
         return null;
-    if (typeof zeichen !== 'string' || zeichen === '')
+    if (typeof charset !== 'string' || charset === '')
         return null;
-    return { stellen, zeichen: zeichen };
+    return { length, charset: charset };
 }
 /**
  * Kassen-Benutzer per PIN anmelden. **Ohne Anmeldung** — dieser Aufruf
@@ -311,7 +311,11 @@ function sitzungAusAntwort(name, daten) {
         },
     };
 }
-/** Transport ohne Anmeldung; `auth` steht zuletzt und ist damit nicht zu ueberschreiben. */
+/**
+ * Transport ohne Anmeldung; `auth` steht zuletzt und ist damit nicht zu
+ * ueberschreiben. Ohne eigene Basis gehen diese Aufrufe an den Kassenweg: sie
+ * sind reine Kassenaufrufe, der Transport leitet sie dorthin.
+ */
 function transportFuer(verbindung) {
     return (0, transport_js_1.createTransport)({ ...verbindung, auth: ohneAnmeldung });
 }

package/dist/cjs/register/session.d.ts

@@ -19,11 +19,11 @@ import type { InternerTransport } from '../client/aufrufe.js';
  * seit 1970).
  *
  * Die Sitzung lebt 90 Sekunden; die Browser-Kasse erneuert alle 30. Ist sie
- * bereits beendet oder uebernommen, antwortet das Backend fachlich ("Sitzung
- * beendet — bitte neu anmelden.") — dann hilft nur eine neue Anmeldung ueber
- * `registerUserLogin`.
+ * bereits beendet oder uebernommen, antwortet das Backend mit dem Code
+ * `session_expired` bzw. `session_ended` (siehe [isRegisterError]); dann hilft
+ * nur eine neue Anmeldung ueber `registerUserLogin` oder `registerPinLogin`.
  */
-export declare function renewRegisterSession(rufen: InternerTransport): Promise<number>;
+export declare function renewRegisterSession(transport: InternerTransport): Promise<number>;
 /**
  * Sitzung beenden und den Lizenzplatz sofort freigeben — der regulaere Weg des
  * Abmeldens.
@@ -34,4 +34,4 @@ export declare function renewRegisterSession(rufen: InternerTransport): Promise<
  * einer harmlosen Vertragsaenderung — ausgerechnet beim Abmelden, dem Aufruf,
  * der auch dann durchgehen soll, wenn sonst nichts mehr geht.
  */
-export declare function endRegisterSession(rufen: InternerTransport): Promise<void>;
+export declare function endRegisterSession(transport: InternerTransport): Promise<void>;

package/dist/cjs/register/session.js

@@ -23,12 +23,12 @@ const errors_js_1 = require("../client/errors.js");
  * seit 1970).
  *
  * Die Sitzung lebt 90 Sekunden; die Browser-Kasse erneuert alle 30. Ist sie
- * bereits beendet oder uebernommen, antwortet das Backend fachlich ("Sitzung
- * beendet — bitte neu anmelden.") — dann hilft nur eine neue Anmeldung ueber
- * `registerUserLogin`.
+ * bereits beendet oder uebernommen, antwortet das Backend mit dem Code
+ * `session_expired` bzw. `session_ended` (siehe [isRegisterError]); dann hilft
+ * nur eine neue Anmeldung ueber `registerUserLogin` oder `registerPinLogin`.
  */
-async function renewRegisterSession(rufen) {
-    const daten = await rufen('renewRegisterSession');
+async function renewRegisterSession(transport) {
+    const daten = await transport('renewRegisterSession');
     const expiresAt = daten?.expiresAt;
     if (typeof expiresAt !== 'number' || !Number.isFinite(expiresAt)) {
         // Ohne brauchbaren Ablaufzeitpunkt weiss die Kasse nicht, wann sie das
@@ -47,6 +47,6 @@ async function renewRegisterSession(rufen) {
  * einer harmlosen Vertragsaenderung — ausgerechnet beim Abmelden, dem Aufruf,
  * der auch dann durchgehen soll, wenn sonst nichts mehr geht.
  */
-async function endRegisterSession(rufen) {
-    await rufen('endRegisterSession');
+async function endRegisterSession(transport) {
+    await transport('endRegisterSession');
 }

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

@@ -0,0 +1,45 @@
+import { type SchemaEintrag, type SchemaObjekt } from './vokabular.js';
+export type Objekt = Record<string, unknown>;
+export declare const hat: (o: object, k: string) => boolean;
+export declare const istObjekt: (w: unknown) => w is Objekt;
+/** Schema-Eintrag zerlegt: innerer Name, Unterschema (ohne `__`) und ob es eine Liste ist. */
+export declare function regel(eintrag: SchemaEintrag): {
+    innen: string;
+    unter: SchemaObjekt | null;
+    liste: boolean;
+};
+/** Innere Namen einer Schema-Ebene (was der Server innen an dieser Stelle kennt). */
+export declare function innereNamen(schema: SchemaObjekt): Map<string, string>;
+/**
+ * Ein Belegdokument, wie Handler und Rand es vor der Uebersetzung sehen:
+ * ohne Storno-Marke (storno-core.ohneInterneStornoFelder, Rand
+ * ohneStornoMarke). Alles andere bleibt woertlich, auch `pruefangaben` im
+ * Beleg selbst (der Server reicht sie so durch). Wirft, wenn es kein
+ * Belegdokument ist.
+ */
+export declare function _storedReceiptInner(doc: unknown, functionName: string): Objekt;
+/**
+ * Registrierdaten der Huelle aus den beim Ausstellen festgehaltenen
+ * `pruefangaben` (Zwilling von `pruefangabenFuerBeleg`, erster Zweig): genau
+ * die zwei Felder, je ueber [alsIso].
+ */
+export declare function pruefangabenDerHuelle(p: Objekt): Objekt;
+/**
+ * Eine Beleg-Huelle der inneren Form (`receipt`, Betriebsfelder, `kopfId`,
+ * `pruefangaben`, `testKasse` ...) in die Drahtform von `getReceipt` unter
+ * `/api/v3` (Kanal `app`: Anbieterdaten bleiben).
+ */
+export declare function _receiptEnvelopeToWire(huelle: Objekt): Objekt;
+/**
+ * Ein Belegdokument (`users/{uid}/cashregisters/{id}/receipts/{id}`) in der
+ * Form von `data.receipt` einer `/api/v3`-Antwort (Kanal `app`: Anbieterdaten
+ * bleiben). Wirft, wenn es kein Belegdokument ist.
+ */
+export declare function _storedReceiptToWire(doc: unknown, functionName?: string): Objekt;
+/**
+ * Ein Artikeldokument (`users/{uid}/articles/{id}`) in der Form eines
+ * Eintrags von `listMyArticles` unter `/api/v3`. Vor dem Rand ergaenzt der
+ * Handler `groupId`/`revenueGroupId` (fehlt -> `null`) und die Kachel
+ * (article-endpoints.js listMyArticles); das steht nicht im Vertrag.
+ */
+export declare function _storedArticleToWire(id: string, doc: unknown, functionName?: string): Objekt;

package/dist/cjs/stored/draht.js

@@ -0,0 +1,220 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.istObjekt = exports.hat = void 0;
+exports.regel = regel;
+exports.innereNamen = innereNamen;
+exports._storedReceiptInner = _storedReceiptInner;
+exports.pruefangabenDerHuelle = pruefangabenDerHuelle;
+exports._receiptEnvelopeToWire = _receiptEnvelopeToWire;
+exports._storedReceiptToWire = _storedReceiptToWire;
+exports._storedArticleToWire = _storedArticleToWire;
+const errors_js_1 = require("../client/errors.js");
+const vokabular_js_1 = require("./vokabular.js");
+const hat = (o, k) => Object.prototype.hasOwnProperty.call(o, k);
+exports.hat = hat;
+const istObjekt = (w) => w !== null && typeof w === 'object' && !Array.isArray(w);
+exports.istObjekt = istObjekt;
+/** Schema-Eintrag zerlegt: innerer Name, Unterschema (ohne `__`) und ob es eine Liste ist. */
+function regel(eintrag) {
+    const liste = Array.isArray(eintrag);
+    const kern = (liste ? eintrag[0] : eintrag);
+    if (typeof kern === 'string')
+        return { innen: kern, unter: null, liste };
+    const { __: innen, ...unter } = kern;
+    return { innen: innen, unter: unter, liste };
+}
+/**
+ * Schluessel innen -> aussen (Zwilling von `schluessel(obj, schema, 'aus')`).
+ * Kopiert, veraendert die Eingabe nie; ein Treffer wandert wie am Server ans
+ * Ende des Objekts.
+ */
+function schluesselNachAussen(obj, schema) {
+    if (!(0, exports.istObjekt)(obj))
+        return obj;
+    const raus = { ...obj };
+    for (const [aussen, eintrag] of Object.entries(schema)) {
+        if (aussen === '__')
+            continue;
+        const { innen, unter, liste } = regel(eintrag);
+        if (!(0, exports.hat)(raus, innen))
+            continue;
+        let wert = raus[innen];
+        if (unter) {
+            wert = liste ? (Array.isArray(wert) ? wert.map((e) => schluesselNachAussen(e, unter)) : wert) : schluesselNachAussen(wert, unter);
+        }
+        delete raus[innen];
+        raus[aussen] = wert;
+    }
+    return raus;
+}
+/** Innere Namen einer Schema-Ebene (was der Server innen an dieser Stelle kennt). */
+function innereNamen(schema) {
+    const raus = new Map();
+    for (const [aussen, eintrag] of Object.entries(schema))
+        if (aussen !== '__')
+            raus.set(regel(eintrag).innen, aussen);
+    return raus;
+}
+/** Wert an einem aeusseren Pfad (`a.b`, `a[].b`) abbilden (Zwilling von `anPfad`). */
+function anPfad(obj, teile, fn) {
+    if (obj == null || teile.length === 0 || typeof obj !== 'object')
+        return obj;
+    const [kopf, ...rest] = teile;
+    const liste = kopf.endsWith('[]');
+    const name = liste ? kopf.slice(0, -2) : kopf;
+    if (!(0, exports.hat)(obj, name))
+        return obj;
+    const wert = obj[name];
+    let neu;
+    if (liste)
+        neu = Array.isArray(wert) ? wert.map((e) => (rest.length ? anPfad(e, rest, fn) : fn(e))) : wert;
+    else
+        neu = rest.length ? anPfad(wert, rest, fn) : fn(wert);
+    return { ...obj, [name]: neu };
+}
+/**
+ * Werte ueber die Kataloge des Vertrags abbilden (Zwilling von
+ * `werteAbbilden`). Ein Wert, den der Katalog nicht kennt, bleibt woertlich
+ * stehen, wie am Server.
+ */
+function werteNachAussen(obj, werte) {
+    let raus = obj;
+    for (const [pfad, { $catalog }] of Object.entries(werte)) {
+        const katalog = vokabular_js_1.KATALOGE[$catalog];
+        if (!katalog)
+            throw new Error(`stored: Katalog ${$catalog} fehlt im Vokabular`);
+        raus = anPfad(raus, pfad.split('.'), (v) => (typeof v === 'string' && (0, exports.hat)(katalog, v) ? katalog[v] : v));
+    }
+    return raus;
+}
+/** Englische Werte eines Katalogs (was an dieser Stelle hinaus darf). */
+const aeussereWerte = (name) => new Set(Object.values(vokabular_js_1.KATALOGE[name] ?? {}));
+// ---- Belege -----------------------------------------------------------------
+/**
+ * Interne Marke der Storno-Reservierung: `stornoMarke` am Storno-Beleg,
+ * `marke` im Bezug und in `cancellations[]`. Handler
+ * (storno-core.ohneInterneStornoFelder) und Rand (ohneStornoMarke) nehmen sie
+ * heraus; der Vertrag nennt die Namen nicht (nur `$function: belegJeKanal`).
+ */
+const STORNO_MARKE = 'stornoMarke';
+const MARKE = 'marke';
+const ohneMarke = (o) => {
+    if (!(0, exports.istObjekt)(o) || !(0, exports.hat)(o, MARKE))
+        return o;
+    const { [MARKE]: _m, ...rest } = o;
+    return rest;
+};
+/**
+ * Zwilling von `beleg-pruefangaben.alsIso`: leer (auch 0, '') -> null;
+ * Firestore-Zeitstempel, Zahl oder Zeichenkette -> ISO-Zeitpunkt in UTC;
+ * nicht lesbar -> null.
+ */
+function alsIso(ts) {
+    if (!ts)
+        return null;
+    let d = ts;
+    if (typeof d.toDate === 'function')
+        d = d.toDate();
+    if (typeof d === 'number' || typeof d === 'string')
+        d = new Date(d);
+    return d instanceof Date && !Number.isNaN(d.getTime()) ? d.toISOString() : null;
+}
+/**
+ * Ein Belegdokument, wie Handler und Rand es vor der Uebersetzung sehen:
+ * ohne Storno-Marke (storno-core.ohneInterneStornoFelder, Rand
+ * ohneStornoMarke). Alles andere bleibt woertlich, auch `pruefangaben` im
+ * Beleg selbst (der Server reicht sie so durch). Wirft, wenn es kein
+ * Belegdokument ist.
+ */
+function _storedReceiptInner(doc, functionName) {
+    if (!(0, exports.istObjekt)(doc) || typeof doc.receiptId !== 'string') {
+        throw new errors_js_1.KasseneckValidationError(functionName, 'Kein Belegdokument (receiptId fehlt)', 'response');
+    }
+    const { [STORNO_MARKE]: _s, ...beleg } = doc;
+    if ((0, exports.hat)(beleg, 'cancellationOf'))
+        beleg.cancellationOf = ohneMarke(beleg.cancellationOf);
+    if (Array.isArray(beleg.cancellations))
+        beleg.cancellations = beleg.cancellations.map(ohneMarke);
+    return beleg;
+}
+/**
+ * Registrierdaten der Huelle aus den beim Ausstellen festgehaltenen
+ * `pruefangaben` (Zwilling von `pruefangabenFuerBeleg`, erster Zweig): genau
+ * die zwei Felder, je ueber [alsIso].
+ */
+function pruefangabenDerHuelle(p) {
+    return { karteRegistriertAm: alsIso(p.karteRegistriertAm), kasseRegistriertAm: alsIso(p.kasseRegistriertAm) };
+}
+/**
+ * Eine Beleg-Huelle der inneren Form (`receipt`, Betriebsfelder, `kopfId`,
+ * `pruefangaben`, `testKasse` ...) in die Drahtform von `getReceipt` unter
+ * `/api/v3` (Kanal `app`: Anbieterdaten bleiben).
+ */
+function _receiptEnvelopeToWire(huelle) {
+    const schema = vokabular_js_1.SCHEMAS.getReceipt;
+    return werteNachAussen(schluesselNachAussen(huelle, schema.data), schema.werte);
+}
+/**
+ * Ein Belegdokument (`users/{uid}/cashregisters/{id}/receipts/{id}`) in der
+ * Form von `data.receipt` einer `/api/v3`-Antwort (Kanal `app`: Anbieterdaten
+ * bleiben). Wirft, wenn es kein Belegdokument ist.
+ */
+function _storedReceiptToWire(doc, functionName = 'fromStoredReceipt') {
+    return _receiptEnvelopeToWire({ receipt: _storedReceiptInner(doc, functionName) }).receipt;
+}
+// ---- Artikel ------------------------------------------------------------------
+/**
+ * Zwilling von `kachelAttribute` (article-groups-core): sichtbar, wenn nicht
+ * ausdruecklich aus; Reihenfolge ganzzahlig ab 0, sonst 0.
+ */
+function kachelAttribute(e) {
+    const k = (0, exports.istObjekt)(e) ? e : {};
+    return {
+        sichtbar: typeof k.sichtbar === 'boolean' ? k.sichtbar : true,
+        sort: Number.isInteger(k.sort) && k.sort >= 0 ? k.sort : 0,
+    };
+}
+/**
+ * Nur bekannte Felder hinaus (Zwilling von `nurBekannte`): ein Feld, das
+ * kein Schreibweg kennt, und ein Katalogwert, den der Katalog nicht kennt,
+ * fallen weg; `undefined` ebenso.
+ */
+function nurBekannte(obj, erlaubt, werte = {}) {
+    const raus = {};
+    for (const [k, w] of Object.entries(obj)) {
+        if (w === undefined || !erlaubt.has(k))
+            continue;
+        if ((0, exports.hat)(werte, k) && w !== null && !werte[k].has(w))
+            continue;
+        raus[k] = w;
+    }
+    return raus;
+}
+/**
+ * Ein Artikeldokument (`users/{uid}/articles/{id}`) in der Form eines
+ * Eintrags von `listMyArticles` unter `/api/v3`. Vor dem Rand ergaenzt der
+ * Handler `groupId`/`revenueGroupId` (fehlt -> `null`) und die Kachel
+ * (article-endpoints.js listMyArticles); das steht nicht im Vertrag.
+ */
+function _storedArticleToWire(id, doc, functionName = 'fromStoredArticle') {
+    if (typeof id !== 'string' || id === '' || !(0, exports.istObjekt)(doc)) {
+        throw new errors_js_1.KasseneckValidationError(functionName, 'Kein Artikeldokument (id oder Daten fehlen)', 'response');
+    }
+    const a = doc;
+    const handler = {
+        id, ...a, groupId: a.groupId || null, revenueGroupId: a.revenueGroupId || null, kasse: kachelAttribute(a.kasse),
+        create_time: undefined, update_time: undefined,
+    };
+    const schema = vokabular_js_1.SCHEMAS.listMyArticles;
+    const huelle = werteNachAussen(schluesselNachAussen({ articles: [handler] }, schema.data), schema.werte);
+    const artikel = huelle.articles[0];
+    const katalog = (pfad) => aeussereWerte(schema.werte[pfad].$catalog);
+    const raus = nurBekannte(artikel, new Set(vokabular_js_1.ARTIKEL_FELDER), {
+        quantityRule: katalog('articles[].quantityRule'), e1aGroup: katalog('articles[].e1aGroup'),
+    });
+    if ((0, exports.istObjekt)(raus.tile)) {
+        const kachel = regel(regel(schema.data.articles).unter.tile).unter;
+        raus.tile = nurBekannte(raus.tile, new Set(Object.keys(kachel)));
+    }
+    return raus;
+}