@kreiseck/kasseneck-api 0.30.0 → 1.0.0-rc.1

package/dist/esm/receipt/layout.js

@@ -2,7 +2,30 @@ import { VatRate, VoucherAction, VoucherType } from '../enums/index.js';
 import { CANCELLATION_REASONS, isCancellationReason, receiptCompanyTaxInfo, receiptItemTotalCents, isDiscountItem, isTipItem, receiptSubSumCents, receiptSumCents, voucherIsValid, } from '../models/index.js';
 import { parseServerTimeStamp, toViennaWallClock } from '../vienna-time.js';
 import { KasseneckValidationError } from '../client/errors.js';
-export const AKTUELLES_REGELWERK = 2;
+export const CURRENT_LAYOUT_RULESET = 2;
+/** Die Optionen von [buildReceiptLayout]; jede andere wird abgewiesen. */
+const LAYOUT_OPTIONEN = new Set(['paperSize', 'ruleset', 'testCashregister', 'testSignature', 'registrationInfo']);
+/** Namen bis 0.x -> Namen seit 1.0 (fuer eine Meldung, die den Weg nennt). */
+const LAYOUT_OPTIONEN_ALT = {
+    testKasse: 'testCashregister',
+    testSignatur: 'testSignature',
+    pruefangaben: 'registrationInfo',
+    regelwerk: 'ruleset',
+};
+/**
+ * Weist unbekannte Optionen ab. Eine alte deutsche Option (`testKasse`) darf
+ * nie still verschwinden: der Rahmen „TESTKASSE — kein gültiger Beleg“ fehlte
+ * sonst auf einem Testbeleg, und der saehe aus wie ein gueltiger. Das gilt
+ * auch fuer Aufrufer ohne Typpruefung (JavaScript).
+ */
+function pruefeLayoutOptionen(options) {
+    for (const name of Object.keys(options)) {
+        if (LAYOUT_OPTIONEN.has(name))
+            continue;
+        const neu = LAYOUT_OPTIONEN_ALT[name];
+        throw new KasseneckValidationError('buildReceiptLayout', neu !== undefined ? `Option "${name}" heisst seit 1.0 "${neu}"` : `Unbekannte Option "${name}"`, 'request');
+    }
+}
 // -------------------------------------------------------------- Formatierung
 /**
  * Cent-Betrag als Anzeigetext: `1234` -> `"12,34"`. Die **einzige** Stelle, an
@@ -78,7 +101,7 @@ function originalDatum(timeStamp) {
  * anderswo noch einmal baut, oeffnet die Drift wieder.
  *
  * Vorbild ist `print_paper.dart` im Dart-Paket (`_gpTom`, `_hobexHps`,
- * `_sumup`, `_mypos`, `_stripe`); die Fixtures unter `fixtures/belege/karte-*`
+ * `_sumup`, `_mypos`, `_stripe`); die Fixtures unter `fixtures/receipts/karte-*`
  * halten je Anbieter eine Zeile-fuer-Zeile-Probe fest.
  */
 /** Ein Feld aus `cardPaymentData` als Text; fehlend/null wird leer. */
@@ -489,7 +512,7 @@ function steuersatz(vat) {
     return { rate: vat.rate, category: vat.category };
 }
 /** `20` -> `"20"`, `4.9` -> `"4,9"` (wie im Vorbild). */
-function satzText(rate) {
+function formatVatRate(rate) {
     return String(rate).replace('.', ',');
 }
 /**
@@ -629,8 +652,8 @@ const TRAINING_ERKLAERUNG = [
     'Trainingsbuchung — kein Kauf, keine Zahlung, keine steuerliche Buchung.',
     'Sollten Sie diesen Beleg als Kunde erhalten haben, sagen Sie bitte dem Betrieb Bescheid.',
 ];
-function bannerZeile(text, ton = 'belegart') {
-    return { kind: 'banner', text, ton };
+function bannerZeile(text, tone = 'receipt_type') {
+    return { kind: 'banner', text, tone };
 }
 /** Belegtyp als Zeichenkette (Enum-Objekt oder roher Serverwert). */
 function belegtyp(receipt) {
@@ -695,10 +718,10 @@ function pruefangabenBlock(receipt, angaben) {
     const zda = receiptZdaText(receipt.qr);
     if (zda)
         out.push(paarZeile('Zertifizierungsdienst:', zda, 7, 5));
-    const karte = pruefDatum(angaben?.karteRegistriertAm);
+    const karte = pruefDatum(angaben?.cardRegisteredAt);
     if (karte)
         out.push(paarZeile('Karte registriert:', karte));
-    const kasse = pruefDatum(angaben?.kasseRegistriertAm);
+    const kasse = pruefDatum(angaben?.cashregisterRegisteredAt);
     if (kasse)
         out.push(paarZeile('Kasse registriert:', kasse));
     out.push({ kind: 'rule', char: '-' });
@@ -790,20 +813,21 @@ function belegartBlock(receipt) {
  * `print_paper.dart` (`setKeckReceipt`).
  */
 export function buildReceiptLayout(receipt, company, options = {}) {
+    pruefeLayoutOptionen(options);
     const paperSize = options.paperSize ?? 'mm58';
-    const regelwerk = options.regelwerk ?? AKTUELLES_REGELWERK;
-    if (regelwerk !== 1 && regelwerk !== 2) {
-        throw new KasseneckValidationError('buildReceiptLayout', `Unbekanntes Layout-Regelwerk ${String(regelwerk)} — bitte Paket aktualisieren`, 'request');
+    const ruleset = options.ruleset ?? CURRENT_LAYOUT_RULESET;
+    if (ruleset !== 1 && ruleset !== 2) {
+        throw new KasseneckValidationError('buildReceiptLayout', `Unbekanntes Layout-Regelwerk (ruleset ${String(ruleset)}), bitte Paket aktualisieren`, 'request');
     }
     const lines = [];
     // Regelwerk 2: ein „Nullbeleg“ mit echten Betraegen wird nicht reduziert --
     // die Zahlen stehen drauf, statt hinter einer Null zu verschwinden.
-    const nullbeleg = receiptIsZero(receipt) && (regelwerk === 1 || receiptAmountsAreZero(receipt));
+    const nullbeleg = receiptIsZero(receipt) && (ruleset === 1 || receiptAmountsAreZero(receipt));
     const warnungen = [];
-    if (options.testKasse)
-        warnungen.push(bannerZeile(TESTKASSE_TEXT, 'warnung'));
-    if (options.testSignatur)
-        warnungen.push(bannerZeile(TESTSIGNATUR_TEXT, 'warnung'));
+    if (options.testCashregister)
+        warnungen.push(bannerZeile(TESTKASSE_TEXT, 'warning'));
+    if (options.testSignature)
+        warnungen.push(bannerZeile(TESTSIGNATUR_TEXT, 'warning'));
     // --- Warnrahmen oben (Testkasse/Testsignatur): ueber dem Kopf, damit ihn niemand uebersieht.
     lines.push(...warnungen);
     // --- Belegkopf: Firma, Anschrift, Steuerangabe, Telefon
@@ -826,11 +850,11 @@ export function buildReceiptLayout(receipt, company, options = {}) {
         lines.push(paarZeile('Kassen-ID:', receipt.cashregisterId));
         lines.push(paarZeile('Beleg-ID:', receipt.receiptId));
         lines.push({ kind: 'space', lines: 1 });
-        if (regelwerk === 1) {
+        if (ruleset === 1) {
             lines.push(textZeile('Betrag: 0,00 €', 'center', true));
         }
         else {
-            lines.push(...pruefangabenBlock(receipt, options.pruefangaben ?? null));
+            lines.push(...pruefangabenBlock(receipt, options.registrationInfo ?? null));
         }
         lines.push({ kind: 'space', lines: 1 });
         if (receiptSignatureFailed(receipt)) {
@@ -840,7 +864,7 @@ export function buildReceiptLayout(receipt, company, options = {}) {
         lines.push({ kind: 'qr', data: receipt.qr });
         lines.push({ kind: 'space', lines: 1 });
         lines.push(...warnungen);
-        return { lines, paperSize, regelwerk };
+        return { lines, paperSize, ruleset };
     }
     // --- Kundendaten
     if (receipt.customerDetails.length > 0) {
@@ -960,7 +984,7 @@ export function buildReceiptLayout(receipt, company, options = {}) {
         const bruttoCents = gruppe.bruttoCents;
         const nettoCents = nettoAusBrutto(bruttoCents, gruppe.satz.rate);
         lines.push(tabellenZeile([
-            `${gruppe.satz.category} ${satzText(gruppe.satz.rate)}%`,
+            `${gruppe.satz.category} ${formatVatRate(gruppe.satz.rate)}%`,
             formatCents(bruttoCents - nettoCents),
             formatCents(nettoCents),
             formatCents(bruttoCents),
@@ -1040,7 +1064,7 @@ export function buildReceiptLayout(receipt, company, options = {}) {
         lines.push({ kind: 'space', lines: 1 });
         lines.push(...warnungen);
     }
-    return { lines, paperSize, regelwerk };
+    return { lines, paperSize, ruleset };
 }
 /**
  * Verteilt einen eingeloesten Promotionsgutschein anteilig auf die

package/dist/esm/receipt/marke-daten.d.ts

@@ -1,14 +1,14 @@
 import type { PosPaperSize } from '../printing/escpos.js';
-export interface MarkeRasterDaten {
-    readonly breite: number;
-    readonly hoehe: number;
+export interface BrandMarkRaster {
+    readonly width: number;
+    readonly height: number;
     /** Rasterzeilen als Bits, MSB zuerst, je Zeile auf volle Bytes aufgefuellt; base64. */
     readonly bits: string;
 }
-export declare const MARKE_RASTER: Readonly<Record<PosPaperSize, MarkeRasterDaten>>;
+export declare const BRAND_MARK_RASTERS: Readonly<Record<PosPaperSize, BrandMarkRaster>>;
 /** Die Marke als Pfade (fuer PDF und Bildschirm), im Kasten der Markendatei. */
-export declare const MARKE_PFADE: {
-    readonly breite: number;
-    readonly hoehe: number;
-    readonly pfade: readonly string[];
+export declare const BRAND_MARK_PATHS: {
+    readonly width: number;
+    readonly height: number;
+    readonly paths: readonly string[];
 };

package/dist/esm/receipt/marke-daten.js

@@ -1,12 +1,12 @@
-export const MARKE_RASTER = {
-    mm80: { breite: 352, hoehe: 51, bits: "////////4AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD////////gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAP///////+AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA////////4AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD////////gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAP///////+AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD8AAA////////4AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAf4AAD+AAAAAAfgAAAD+AAH/AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAB/gAAP4AAAAAB+AAAAf4AA/8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAH+AAA/gAAAAAH4AAAB/gAH/gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAf4AAD+AAAAAAfgAAAH+AAf8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAB/gAAP4AAAAAB+AAAAf4AD/gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAH+AAA/gAAAAAH4AAAB/gAf8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAf4AAD+AAAAAAfgAAAH+AD/gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAB/gAAP4AAAAAB+AAAAf4Af8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAH+AAA/gAAAAAH4AAAB/gD/gAAPgAAAHgAAAHgAAAPgAAAAeAAAB8AAAB8AAf4AAD+AAAAAAfgAAAH+Af8AAP/4AAP/8AAP/4AAP/4AH4P/AAB//AAB//AB/gB/v4AAAAAB+AAAAf4D/gAD//4AD//8AD//4AD//4Afj//AAf//AAP//AH+AP8/gAAAAAH4AAAB/gf8AAf//wAf//4Af//wAf//wB+f/+AD//+AD//+Af4B/j+AAAAAAfgAAAH+D/gAD///gD///wD///gD///gH///4Af//8Af//8B/gP8P4AAAAAB+AAAAf4f8AAf///Af///Af///Af///Af///wD///4B///4H+B/g/gAAAAAH4AAAB/j/gAB/gf8B/wP+D/gf8B/wP8B////Af+D/gP/D/wf4P+D+AAAAAAfgAAAH+f8AAH8AfwH8Af4P8Af4P8Af4H/gP+B/gD/A/wD/B/g/wP4AAAAAB+AAAAf7/wAA/wB/A/wA/g/gA/g/wA/gf8Af4P8AP8H+AH8H+H+A/gAAAAAH4AAAB///gAB+AH8D/AD+D+AD+D+AD/B/gB/g/wAfwfwAfwf4/wD+AAAAAAfgAAAH///AAAAAf4P+AAAP8AAAf4AH8H+AD+D+AB/B/AB/h/n+AP4AAAAAB+AAAAf//8AAAAB/gf+AAA/8AAB/AAfwfwAP4P4AH+P8AH+H+/wA/gAAAAAH4AAAB///4AAAAH+B//AAB//AAH+AD/B/AA/g/gAf4/wAAAf//AD+AAAAAAfgAAAH///wAAD//4D//wAH//gAf///8H8AD+D////j+AAAB//8AP4AAAAAB+AAAAf/j/AAB///gP//4AP//wB////wfwAP4f///+P4AAAH//wA/gAAAAAH4AAAB/8P+AAf//+AP//4Af//wH////B/AA/h////4/gAAAf//gD+AAAAAA/gAAAH/gf8AD///4Af//wAf//gf///8H8AD+H////j+AAAB///AP4AAAD//+AAAAf8A/wAf///gAP//gAf//B////wfwAP4f///+P4AAAH//8A/gAAAP//4AAAB/gD/gD/wH+AAH/+AAH/+H8AAAB/AA/g/gAAA/gAAAf/f4D+AAAA///gAAAH+AH/AP8Af4AAB/8AAD/4fwAAAH8AD+D+AAAD/AAAB/4/gP4AAAD//+AAAAf4AP8B/gB/gAAB/wAAB/h/AAfwfwAP4P4AD8P8AD+H/D/A/gAAAP//4AAAB/gA/4H8AH+D8AD/D8AD/H+AB/B/AA/g/gAP4fwAP4f4H8D+AAAA///gAAAH+AB/wfwAf4P4AH8fwAP8P4AH8H8AD+D/AB/h/AB/B/gf4P4AAAD//+AAAAf4AD/B/AD/g/gAfx/gA/g/wA/wfwAP4H8AH8H+AH8H+A/w/gAAAP//4AAAB/gAP+H+Af+D/AD/D/AD+D/AH+B/AA/gf4A/wP8A/wf4D/D+AAAA///gAAAH+AAf8f+P/8P/A/4P/A/4H/A/4H8AD+B/4P/A/8P+B/gH+P4AAAD//+AAAAf4AA/w////8f///g////Af///AfwAP4D///4B///4H+Af4/gAAAP//4AAAB/gAD/j////w///8B///8A///8B/AA/gH///AH///Af4A/z+AAAA///gAAAH+AAH/H//n/B///gD///gB///gH8AD+AP//4AP//4B/gD/P4AAAH//+AAAAf4AAf8P/8f8D//8AD//8AB//4AfwAP4Af//AAP//AH+AH+////////4AAAA/gAA/4f/A/wD//AAD/+AAB/+AB/AA/gAf/wAAP/wAPwAP7////////gAAAAAAAAAAHAAAAAeAAAAcAAAAeAAAAAAAAADgAAADgAAAAAAP///////+AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA////////4AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD////////gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAP///////+AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA" },
-    mm58: { breite: 234, hoehe: 34, bits: "/////8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA/////8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA/////8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA/////8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAeAAA+AAAB8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA+AAA8AAAA8AAHwAfgAAAAAAAAAAAAAAAAAAAAAAA+AAA8AAAA8AAHwA/AAAAAAAAAAAAAAAAAAAAAAAA+AAA8AAAA8AAHwB+AAAAAAAAAAAAAAAAAAAAAAAA+AAA8AAAA8AAHwD8AAAAAAAAAAAAAAAAAAAAAAAA+AAA8AAAA8AAHwH4AAAAAAAAAAAAAAAAAAAAAAAA+AAA8AAAA8AAHwPwAPwAD8AA+AAPwAAfAAPgAD4A+AAA8AAAA8AAHwfgB/8AP/AH/wB/8B5/wB/8Af/A+B+A8AAAA8AAHw/AD/+A//wP/4D/+B7/4D/+A//g+D8A8AAAA8AAHx+AH//B//4f/8H//B//4H//B//w+D4A8AAAA8AAHz+AHwfB8H4fB+H4fh/n8PwfB+P4+HwA8AAAA8AAH/8AHwPh8D4+A+PgPh+B8PgPj8D4+PgA8AAAA8AAH/+AHgPh8B4+AcPgPh8B8PgPj4D4+fgA8AAAA8AAH/+AAAPh+AA/gAPgHh8B8fAPj4D4+/AA8AAAA8AAH//AAA/h/4Af8AP//x8B8f//jwAA/+AA8AAAA8AAH/fgA//g//Af/gf//x8B8f//jwAA//AA8AAAA8AAH8PgD//gf/wH/4f//x8B8f//nwAA//AA8AAD/8AAH4PwH//gH/4B/8f//x8B8f//nwAA//gA8AAH/8AAH4H4P4PgA/4AP+PAAB8B8fAADwAA/vgA8AAH/8AAHwH4PgPgAD8AB+PgCh8B8fAAD4B4/HwA8AAH/8AAHwD8PgPj4B88A+PgHx8B8fAHj4D4+HwA8AAH/8AAHwB+Pgfj4B8+A+PgHh8B8PgPj4D4+D4A8AAH/8AAHwB+Pg/j8D4/A+HwPh8B8Pwfh8H4+D8A8AAH/8AAHwA/P//5//4f/+H//h8B8H//B//w+B8A8AAH/8AAHwAfn//4//wf/8D//B8B8D//A//g+B+A+AAH/8AAHwAfn/n4f/gP/4B/+B8B8B/8Af/A+A+A/////8AADwAPh+D4H+AB/gAf4B4A8AfwAH8AeAeA/////8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA/////8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA/////8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA" },
+export const BRAND_MARK_RASTERS = {
+    mm80: { width: 352, height: 51, bits: "////////4AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD////////gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAP///////+AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA////////4AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD////////gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAP///////+AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD8AAA////////4AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAf4AAD+AAAAAAfgAAAD+AAH/AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAB/gAAP4AAAAAB+AAAAf4AA/8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAH+AAA/gAAAAAH4AAAB/gAH/gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAf4AAD+AAAAAAfgAAAH+AAf8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAB/gAAP4AAAAAB+AAAAf4AD/gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAH+AAA/gAAAAAH4AAAB/gAf8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAf4AAD+AAAAAAfgAAAH+AD/gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAB/gAAP4AAAAAB+AAAAf4Af8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAH+AAA/gAAAAAH4AAAB/gD/gAAPgAAAHgAAAHgAAAPgAAAAeAAAB8AAAB8AAf4AAD+AAAAAAfgAAAH+Af8AAP/4AAP/8AAP/4AAP/4AH4P/AAB//AAB//AB/gB/v4AAAAAB+AAAAf4D/gAD//4AD//8AD//4AD//4Afj//AAf//AAP//AH+AP8/gAAAAAH4AAAB/gf8AAf//wAf//4Af//wAf//wB+f/+AD//+AD//+Af4B/j+AAAAAAfgAAAH+D/gAD///gD///wD///gD///gH///4Af//8Af//8B/gP8P4AAAAAB+AAAAf4f8AAf///Af///Af///Af///Af///wD///4B///4H+B/g/gAAAAAH4AAAB/j/gAB/gf8B/wP+D/gf8B/wP8B////Af+D/gP/D/wf4P+D+AAAAAAfgAAAH+f8AAH8AfwH8Af4P8Af4P8Af4H/gP+B/gD/A/wD/B/g/wP4AAAAAB+AAAAf7/wAA/wB/A/wA/g/gA/g/wA/gf8Af4P8AP8H+AH8H+H+A/gAAAAAH4AAAB///gAB+AH8D/AD+D+AD+D+AD/B/gB/g/wAfwfwAfwf4/wD+AAAAAAfgAAAH///AAAAAf4P+AAAP8AAAf4AH8H+AD+D+AB/B/AB/h/n+AP4AAAAAB+AAAAf//8AAAAB/gf+AAA/8AAB/AAfwfwAP4P4AH+P8AH+H+/wA/gAAAAAH4AAAB///4AAAAH+B//AAB//AAH+AD/B/AA/g/gAf4/wAAAf//AD+AAAAAAfgAAAH///wAAD//4D//wAH//gAf///8H8AD+D////j+AAAB//8AP4AAAAAB+AAAAf/j/AAB///gP//4AP//wB////wfwAP4f///+P4AAAH//wA/gAAAAAH4AAAB/8P+AAf//+AP//4Af//wH////B/AA/h////4/gAAAf//gD+AAAAAA/gAAAH/gf8AD///4Af//wAf//gf///8H8AD+H////j+AAAB///AP4AAAD//+AAAAf8A/wAf///gAP//gAf//B////wfwAP4f///+P4AAAH//8A/gAAAP//4AAAB/gD/gD/wH+AAH/+AAH/+H8AAAB/AA/g/gAAA/gAAAf/f4D+AAAA///gAAAH+AH/AP8Af4AAB/8AAD/4fwAAAH8AD+D+AAAD/AAAB/4/gP4AAAD//+AAAAf4AP8B/gB/gAAB/wAAB/h/AAfwfwAP4P4AD8P8AD+H/D/A/gAAAP//4AAAB/gA/4H8AH+D8AD/D8AD/H+AB/B/AA/g/gAP4fwAP4f4H8D+AAAA///gAAAH+AB/wfwAf4P4AH8fwAP8P4AH8H8AD+D/AB/h/AB/B/gf4P4AAAD//+AAAAf4AD/B/AD/g/gAfx/gA/g/wA/wfwAP4H8AH8H+AH8H+A/w/gAAAP//4AAAB/gAP+H+Af+D/AD/D/AD+D/AH+B/AA/gf4A/wP8A/wf4D/D+AAAA///gAAAH+AAf8f+P/8P/A/4P/A/4H/A/4H8AD+B/4P/A/8P+B/gH+P4AAAD//+AAAAf4AA/w////8f///g////Af///AfwAP4D///4B///4H+Af4/gAAAP//4AAAB/gAD/j////w///8B///8A///8B/AA/gH///AH///Af4A/z+AAAA///gAAAH+AAH/H//n/B///gD///gB///gH8AD+AP//4AP//4B/gD/P4AAAH//+AAAAf4AAf8P/8f8D//8AD//8AB//4AfwAP4Af//AAP//AH+AH+////////4AAAA/gAA/4f/A/wD//AAD/+AAB/+AB/AA/gAf/wAAP/wAPwAP7////////gAAAAAAAAAAHAAAAAeAAAAcAAAAeAAAAAAAAADgAAADgAAAAAAP///////+AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA////////4AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAD////////gAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAP///////+AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA" },
+    mm58: { width: 234, height: 34, bits: "/////8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA/////8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA/////8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA/////8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAeAAA+AAAB8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAA+AAA8AAAA8AAHwAfgAAAAAAAAAAAAAAAAAAAAAAA+AAA8AAAA8AAHwA/AAAAAAAAAAAAAAAAAAAAAAAA+AAA8AAAA8AAHwB+AAAAAAAAAAAAAAAAAAAAAAAA+AAA8AAAA8AAHwD8AAAAAAAAAAAAAAAAAAAAAAAA+AAA8AAAA8AAHwH4AAAAAAAAAAAAAAAAAAAAAAAA+AAA8AAAA8AAHwPwAPwAD8AA+AAPwAAfAAPgAD4A+AAA8AAAA8AAHwfgB/8AP/AH/wB/8B5/wB/8Af/A+B+A8AAAA8AAHw/AD/+A//wP/4D/+B7/4D/+A//g+D8A8AAAA8AAHx+AH//B//4f/8H//B//4H//B//w+D4A8AAAA8AAHz+AHwfB8H4fB+H4fh/n8PwfB+P4+HwA8AAAA8AAH/8AHwPh8D4+A+PgPh+B8PgPj8D4+PgA8AAAA8AAH/+AHgPh8B4+AcPgPh8B8PgPj4D4+fgA8AAAA8AAH/+AAAPh+AA/gAPgHh8B8fAPj4D4+/AA8AAAA8AAH//AAA/h/4Af8AP//x8B8f//jwAA/+AA8AAAA8AAH/fgA//g//Af/gf//x8B8f//jwAA//AA8AAAA8AAH8PgD//gf/wH/4f//x8B8f//nwAA//AA8AAD/8AAH4PwH//gH/4B/8f//x8B8f//nwAA//gA8AAH/8AAH4H4P4PgA/4AP+PAAB8B8fAADwAA/vgA8AAH/8AAHwH4PgPgAD8AB+PgCh8B8fAAD4B4/HwA8AAH/8AAHwD8PgPj4B88A+PgHx8B8fAHj4D4+HwA8AAH/8AAHwB+Pgfj4B8+A+PgHh8B8PgPj4D4+D4A8AAH/8AAHwB+Pg/j8D4/A+HwPh8B8Pwfh8H4+D8A8AAH/8AAHwA/P//5//4f/+H//h8B8H//B//w+B8A8AAH/8AAHwAfn//4//wf/8D//B8B8D//A//g+B+A+AAH/8AAHwAfn/n4f/gP/4B/+B8B8B/8Af/A+A+A/////8AADwAPh+D4H+AB/gAf4B4A8AfwAH8AeAeA/////8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA/////8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA/////8AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA" },
 };
 /** Die Marke als Pfade (fuer PDF und Bildschirm), im Kasten der Markendatei. */
-export const MARKE_PFADE = {
-    breite: 332,
-    hoehe: 48,
-    pfade: [
+export const BRAND_MARK_PATHS = {
+    width: 332,
+    height: 48,
+    paths: [
         "M0 0H48V30H42V6H0Z",
         "M0 6V48H30V42H6V6Z",
         "M30 30H48V48H30Z",

package/dist/esm/receipt/marke.d.ts

@@ -1,20 +1,20 @@
-import type { PosPaperSize, RasterBild } from '../printing/escpos.js';
+import type { PosPaperSize, RasterImage } from '../printing/escpos.js';
 /**
  * Entpackt gepackte Rasterzeilen (Base64, MSB zuerst, je Zeile auf volle Bytes
- * aufgefuellt -- die Form von [rasterZeilenBytes]) in ein Punkt-je-Byte-Bild.
+ * aufgefuellt -- die Form von [rasterRowsBytes]) in ein Punkt-je-Byte-Bild.
  *
- * Eigene, exportierte Funktion statt Code inline in `markeBild`: ein
- * Rundlauf-Test (packen mit `rasterZeilenBytes`, entpacken hiermit) kann so
+ * Eigene, exportierte Funktion statt Code inline in `brandMarkImage`: ein
+ * Rundlauf-Test (packen mit `rasterRowsBytes`, entpacken hiermit) kann so
  * denselben Entpacker pruefen, den die Marke zur Laufzeit auch benutzt --
  * ein vertauschter Bit-Index waere sonst nur am schiefen Ausdruck sichtbar.
  */
-export declare function entpackeRasterBits(bits: string, breite: number, hoehe: number): RasterBild;
+export declare function entpackeRasterBits(bits: string, breite: number, hoehe: number): RasterImage;
 /**
  * Die Marke als Rasterbild fuer diese Papierbreite.
  *
  * Entpackt die gepackten Zeilen in ein Punkt-je-Byte-Bild, wie es
- * [escPosRasterBild] erwartet. Zur Laufzeit wird nichts gerechnet und nichts
+ * [escPosRasterImage] erwartet. Zur Laufzeit wird nichts gerechnet und nichts
  * skaliert -- die beiden Masse stehen fest, damit JS und Dart fuer denselben
  * Beleg dieselben Bytes erzeugen.
  */
-export declare function markeBild(paperSize: PosPaperSize): RasterBild;
+export declare function brandMarkImage(paperSize: PosPaperSize): RasterImage;

package/dist/esm/receipt/marke.js

@@ -1,5 +1,5 @@
-import { MARKE_RASTER } from './marke-daten.js';
-/** Base64 -> Bytes ohne `Buffer` -- laeuft im Browser und in Node gleich (wie `rasterZeilenBase64`). */
+import { BRAND_MARK_RASTERS } from './marke-daten.js';
+/** Base64 -> Bytes ohne `Buffer` -- laeuft im Browser und in Node gleich (wie `rasterRowsBase64`). */
 function base64Bytes(base64) {
     const binaer = atob(base64);
     const bytes = new Uint8Array(binaer.length);
@@ -9,10 +9,10 @@ function base64Bytes(base64) {
 }
 /**
  * Entpackt gepackte Rasterzeilen (Base64, MSB zuerst, je Zeile auf volle Bytes
- * aufgefuellt -- die Form von [rasterZeilenBytes]) in ein Punkt-je-Byte-Bild.
+ * aufgefuellt -- die Form von [rasterRowsBytes]) in ein Punkt-je-Byte-Bild.
  *
- * Eigene, exportierte Funktion statt Code inline in `markeBild`: ein
- * Rundlauf-Test (packen mit `rasterZeilenBytes`, entpacken hiermit) kann so
+ * Eigene, exportierte Funktion statt Code inline in `brandMarkImage`: ein
+ * Rundlauf-Test (packen mit `rasterRowsBytes`, entpacken hiermit) kann so
  * denselben Entpacker pruefen, den die Marke zur Laufzeit auch benutzt --
  * ein vertauschter Bit-Index waere sonst nur am schiefen Ausdruck sichtbar.
  */
@@ -26,17 +26,17 @@ export function entpackeRasterBits(bits, breite, hoehe) {
             punkte[y * breite + x] = (byte >> (7 - (x & 7))) & 1;
         }
     }
-    return { breite, hoehe, punkte };
+    return { width: breite, height: hoehe, dots: punkte };
 }
 /**
  * Die Marke als Rasterbild fuer diese Papierbreite.
  *
  * Entpackt die gepackten Zeilen in ein Punkt-je-Byte-Bild, wie es
- * [escPosRasterBild] erwartet. Zur Laufzeit wird nichts gerechnet und nichts
+ * [escPosRasterImage] erwartet. Zur Laufzeit wird nichts gerechnet und nichts
  * skaliert -- die beiden Masse stehen fest, damit JS und Dart fuer denselben
  * Beleg dieselben Bytes erzeugen.
  */
-export function markeBild(paperSize) {
-    const d = MARKE_RASTER[paperSize];
-    return entpackeRasterBits(d.bits, d.breite, d.hoehe);
+export function brandMarkImage(paperSize) {
+    const d = BRAND_MARK_RASTERS[paperSize];
+    return entpackeRasterBits(d.bits, d.width, d.height);
 }

package/dist/esm/register/errors.d.ts

@@ -0,0 +1,61 @@
+import { KasseneckApiError } from '../client/errors.js';
+/**
+ * Fehler der Kassen-Anmeldung (Kopplung, Benutzerliste, PIN-Anmeldung,
+ * Sitzung, Entkoppeln) auswerten: **am `code`, nie am Meldungstext.**
+ *
+ * Bis 0.x verglich die Web-Kasse deutsche Meldungen („Kasse wird gerade auf …
+ * verwendet“) und zog Zahlen aus dem Text. Unter `/api/v3` traegt jede
+ * Abweisung einen Code (Nachtrag §11.7.4) und ihre Angaben als Daten:
+ * `deviceLabel`, `takeoverAllowed`, `retryAfterSec`, `distanceM`,
+ * `pairedDevices`, `licenses`. Die `message` bleibt ein deutscher Menschentext
+ * zum Anzeigen, sie ist kein Vertrag.
+ *
+ * Die Liste ist aus dem Vertrags-Export abgeleitet (Fehlerfaelle der acht
+ * Anmelde-Endpunkte in `fixtures/v3/antworten/kasse.json` und die
+ * Handler-Codes aus `v3-vokabular.json`); ein Test haelt sie deckungsgleich.
+ * Dazu kommen die Codes, die der Rand auf jedem Kassen-Endpunkt erzeugen kann:
+ * die Anmelde- und Pruefcodes (`errorCodes.auth` ohne die sieben des
+ * Partner-Zugangs, z. B. `register_user_not_found`, wenn der Chef einen
+ * angemeldeten Benutzer loescht) und die des Rands selbst (`errorCodes.edge`:
+ * `validation`, `not_found`, `internal_translation_error`, `dialect_mismatch`,
+ * `response_translation_failed`). Ein Code, der in keiner Liste steht, bleibt
+ * ueber `KasseneckApiError.code` lesbar; die Kasse braucht dafuer einen
+ * Rueckfallzweig.
+ */
+export declare const REGISTER_ERROR_CODES: readonly ["account_not_found", "admin_required", "cashregister_in_use", "cashregister_not_assigned", "cashregister_not_found", "cashregister_token_invalid", "cashregister_token_missing", "device_bound_elsewhere", "device_not_found", "device_not_paired", "device_takeover_required", "dialect_mismatch", "internal_translation_error", "licenses_exhausted", "live_not_enabled", "location_outside", "location_required", "login_failed", "login_mode_select_user", "login_unavailable", "method_not_allowed", "mfa_required", "not_found", "pairing_code_expired", "pairing_code_unknown", "pairing_code_used", "pairing_failed", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "register_user_only", "response_translation_failed", "session_ended", "session_expired", "session_not_running", "session_other_cashregister", "too_many_attempts", "unauthorized", "user_disabled", "user_verification_failed", "validation", "route_missing"];
+export type RegisterErrorCode = typeof REGISTER_ERROR_CODES[number];
+export declare function isRegisterErrorCode(value: unknown): value is RegisterErrorCode;
+/** Der Code eines geworfenen Fehlers, wenn es einer der Kassen-Anmeldung ist; sonst `undefined`. */
+export declare function registerErrorCode(error: unknown): RegisterErrorCode | undefined;
+/**
+ * Kurzform fuer `catch (e) { if (isRegisterError(e, 'cashregister_in_use')) … }`.
+ * Ohne `code`: ist es ueberhaupt ein Fehler der Kassen-Anmeldung?
+ */
+export declare function isRegisterError(error: unknown, code?: RegisterErrorCode): error is KasseneckApiError;
+/**
+ * Die Angaben einer Abweisung, soweit sie welche traegt. Was fehlt, ist
+ * `null`; `deviceLabel` ist auch dann `null`, wenn das belegende Geraet keinen
+ * Namen hat (die Oberflaeche sagt dann „ein anderes Geraet“).
+ */
+export interface RegisterErrorDetails {
+    /** `cashregister_in_use`, `device_takeover_required`: Name des Geraets, das die Kasse haelt. */
+    deviceLabel: string | null;
+    /** `cashregister_in_use`: darf dieser Benutzer die Kasse uebernehmen (Recht `takeover`)? */
+    takeoverAllowed: boolean;
+    /** `too_many_attempts`: Sekunden bis zum naechsten Versuch. */
+    retryAfterSec: number | null;
+    /** `location_outside`: Abstand zum Betrieb in Metern. */
+    distanceM: number | null;
+    /** `licenses_exhausted`: gekoppelte Geraete und Lizenzen. */
+    pairedDevices: number | null;
+    licenses: number | null;
+}
+export declare function registerErrorDetails(error: unknown): RegisterErrorDetails;
+/** Ein Feldfehler aus `data.errors[]` einer `validation`-Antwort. */
+export interface RegisterFieldError {
+    /** Feldpfad in der gesendeten Anfrage, z. B. `pairingCode` oder `pin`. */
+    field: string;
+    message: string;
+}
+/** Die Feldfehler einer `validation`-Antwort; leer, wenn es keine sind. */
+export declare function registerFieldErrors(error: unknown): RegisterFieldError[];

package/dist/esm/register/errors.js

@@ -0,0 +1,104 @@
+import { KasseneckApiError } from '../client/errors.js';
+import { feldfehlerVon } from '../client/fehlercodes.js';
+/**
+ * Fehler der Kassen-Anmeldung (Kopplung, Benutzerliste, PIN-Anmeldung,
+ * Sitzung, Entkoppeln) auswerten: **am `code`, nie am Meldungstext.**
+ *
+ * Bis 0.x verglich die Web-Kasse deutsche Meldungen („Kasse wird gerade auf …
+ * verwendet“) und zog Zahlen aus dem Text. Unter `/api/v3` traegt jede
+ * Abweisung einen Code (Nachtrag §11.7.4) und ihre Angaben als Daten:
+ * `deviceLabel`, `takeoverAllowed`, `retryAfterSec`, `distanceM`,
+ * `pairedDevices`, `licenses`. Die `message` bleibt ein deutscher Menschentext
+ * zum Anzeigen, sie ist kein Vertrag.
+ *
+ * Die Liste ist aus dem Vertrags-Export abgeleitet (Fehlerfaelle der acht
+ * Anmelde-Endpunkte in `fixtures/v3/antworten/kasse.json` und die
+ * Handler-Codes aus `v3-vokabular.json`); ein Test haelt sie deckungsgleich.
+ * Dazu kommen die Codes, die der Rand auf jedem Kassen-Endpunkt erzeugen kann:
+ * die Anmelde- und Pruefcodes (`errorCodes.auth` ohne die sieben des
+ * Partner-Zugangs, z. B. `register_user_not_found`, wenn der Chef einen
+ * angemeldeten Benutzer loescht) und die des Rands selbst (`errorCodes.edge`:
+ * `validation`, `not_found`, `internal_translation_error`, `dialect_mismatch`,
+ * `response_translation_failed`). Ein Code, der in keiner Liste steht, bleibt
+ * ueber `KasseneckApiError.code` lesbar; die Kasse braucht dafuer einen
+ * Rueckfallzweig.
+ */
+export const REGISTER_ERROR_CODES = Object.freeze([
+    'account_not_found',
+    'admin_required',
+    'cashregister_in_use',
+    'cashregister_not_assigned',
+    'cashregister_not_found',
+    'cashregister_token_invalid',
+    'cashregister_token_missing',
+    'device_bound_elsewhere',
+    'device_not_found',
+    'device_not_paired',
+    'device_takeover_required',
+    'dialect_mismatch',
+    'internal_translation_error',
+    'licenses_exhausted',
+    'live_not_enabled',
+    'location_outside',
+    'location_required',
+    'login_failed',
+    'login_mode_select_user',
+    'login_unavailable',
+    'method_not_allowed',
+    'mfa_required',
+    'not_found',
+    'pairing_code_expired',
+    'pairing_code_unknown',
+    'pairing_code_used',
+    'pairing_failed',
+    'register_user_no_business',
+    'register_user_not_allowed',
+    'register_user_not_found',
+    'register_user_only',
+    'response_translation_failed',
+    'session_ended',
+    'session_expired',
+    'session_not_running',
+    'session_other_cashregister',
+    'too_many_attempts',
+    'unauthorized',
+    'user_disabled',
+    'user_verification_failed',
+    'validation',
+    // Code des Pakets (CLIENT_ERROR_CODES): HTML statt Backend, der Aufruf kam nie an
+    'route_missing',
+]);
+const BEKANNT = new Set(REGISTER_ERROR_CODES);
+export function isRegisterErrorCode(value) {
+    return typeof value === 'string' && BEKANNT.has(value);
+}
+/** Der Code eines geworfenen Fehlers, wenn es einer der Kassen-Anmeldung ist; sonst `undefined`. */
+export function registerErrorCode(error) {
+    if (!(error instanceof KasseneckApiError))
+        return undefined;
+    return isRegisterErrorCode(error.code) ? error.code : undefined;
+}
+/**
+ * Kurzform fuer `catch (e) { if (isRegisterError(e, 'cashregister_in_use')) … }`.
+ * Ohne `code`: ist es ueberhaupt ein Fehler der Kassen-Anmeldung?
+ */
+export function isRegisterError(error, code) {
+    const gefunden = registerErrorCode(error);
+    return gefunden !== undefined && (code === undefined || gefunden === code);
+}
+export function registerErrorDetails(error) {
+    const d = error instanceof KasseneckApiError ? error.details : {};
+    const zahl = (v) => (typeof v === 'number' && Number.isFinite(v) ? v : null);
+    return {
+        deviceLabel: typeof d['deviceLabel'] === 'string' && d['deviceLabel'] !== '' ? d['deviceLabel'] : null,
+        takeoverAllowed: d['takeoverAllowed'] === true,
+        retryAfterSec: zahl(d['retryAfterSec']),
+        distanceM: zahl(d['distanceM']),
+        pairedDevices: zahl(d['pairedDevices']),
+        licenses: zahl(d['licenses']),
+    };
+}
+/** Die Feldfehler einer `validation`-Antwort; leer, wenn es keine sind. */
+export function registerFieldErrors(error) {
+    return feldfehlerVon(error);
+}

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

@@ -43,9 +43,22 @@
  * });
  * ```
  *
+ * Abweisungen entscheidet die Kasse am Code, nie am Meldungstext:
+ *
+ * ```ts
+ * } catch (e) {
+ *   if (isRegisterError(e, 'cashregister_in_use')) {
+ *     const { deviceLabel, takeoverAllowed } = registerErrorDetails(e);
+ *   } else if (isRegisterError(e, 'too_many_attempts')) {
+ *     const { retryAfterSec } = registerErrorDetails(e);
+ *   }
+ * }
+ * ```
+ *
  * Mit `sitzung.customToken` meldet sich der Verbraucher beim Anmeldedienst an; das
  * daraus entstehende ID-Token und `sitzung.sessionId` ergeben zusammen
  * `registerUserAuth` — ab da laeuft alles Weitere ueber den ueblichen Weg.
  */
-export { type RegisterDeviceConnection, type RegisterDeviceCredentials, type PairRegisterDeviceOptions, type PairedRegisterDevice, type RegisterUserKind, type RegisterUserSummary, type RegisterUserPerms, REGISTER_PERMS, type RegisterScope, type RegisterUser, type RegisterUserSession, type ListRegisterUsersForDeviceOptions, type RegisterUserLoginOptions, type RegisterPinLoginOptions, type RegisterPinPolicy, type RegisterLoginMode, type RegisterDeviceUsers, type RegisterClientInfo, type RegisterGeo, type RegisterGeraeteAngaben, type RegisterSession, type RegisterSessionsStand, type ListRegisterSessionsForDeviceOptions, pairRegisterDevice, listRegisterUsersForDevice, listRegisterSessionsForDevice, unpairRegisterDevice, registerUserLogin, registerPinLogin, } from './pairing.js';
+export { type RegisterDeviceConnection, type RegisterDeviceCredentials, type PairRegisterDeviceOptions, type PairedRegisterDevice, type RegisterUserKind, type RegisterUserSummary, type RegisterUserPerms, REGISTER_PERMS, type RegisterScope, type RegisterUser, type RegisterUserSession, type ListRegisterUsersForDeviceOptions, type RegisterUserLoginOptions, type RegisterPinLoginOptions, type RegisterPinPolicy, type RegisterLoginMode, type RegisterDeviceUsers, type RegisterClientInfo, type RegisterGeo, type RegisterDeviceInfo, type RegisterSession, type RegisterSessionOverview, type ListRegisterSessionsForDeviceOptions, pairRegisterDevice, listRegisterUsersForDevice, listRegisterSessionsForDevice, unpairRegisterDevice, registerUserLogin, registerPinLogin, } from './pairing.js';
 export { renewRegisterSession, endRegisterSession } from './session.js';
+export { REGISTER_ERROR_CODES, type RegisterErrorCode, isRegisterErrorCode, registerErrorCode, registerFieldErrors, type RegisterFieldError, isRegisterError, type RegisterErrorDetails, registerErrorDetails, } from './errors.js';

package/dist/esm/register/index.js

@@ -43,9 +43,22 @@
  * });
  * ```
  *
+ * Abweisungen entscheidet die Kasse am Code, nie am Meldungstext:
+ *
+ * ```ts
+ * } catch (e) {
+ *   if (isRegisterError(e, 'cashregister_in_use')) {
+ *     const { deviceLabel, takeoverAllowed } = registerErrorDetails(e);
+ *   } else if (isRegisterError(e, 'too_many_attempts')) {
+ *     const { retryAfterSec } = registerErrorDetails(e);
+ *   }
+ * }
+ * ```
+ *
  * Mit `sitzung.customToken` meldet sich der Verbraucher beim Anmeldedienst an; das
  * daraus entstehende ID-Token und `sitzung.sessionId` ergeben zusammen
  * `registerUserAuth` — ab da laeuft alles Weitere ueber den ueblichen Weg.
  */
 export { REGISTER_PERMS, pairRegisterDevice, listRegisterUsersForDevice, listRegisterSessionsForDevice, unpairRegisterDevice, registerUserLogin, registerPinLogin, } from './pairing.js';
 export { renewRegisterSession, endRegisterSession } from './session.js';
+export { REGISTER_ERROR_CODES, isRegisterErrorCode, registerErrorCode, registerFieldErrors, isRegisterError, registerErrorDetails, } from './errors.js';