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

package/dist/esm/kasse/drucker.d.ts

@@ -1,59 +0,0 @@
-import type { InternerTransport } from '../client/aufrufe.js';
-import type { ReceiptLayout } from '../receipt/layout.js';
-import type { DruckLogo } from '../receipt/layout-escpos.js';
-/**
- * Netzwerk-Bondrucker ueber Epson "Server Direct Print": das Backend fuehrt
- * je Konto Drucker mit einer geheimen Abhol-URL; die Kasse legt Druckjobs
- * aus einem Zeilenmodell an, der Drucker holt sie selbst ab (alle paar
- * Sekunden) und meldet das Ergebnis. So druckt jeder Browser -- ohne lokale
- * Software. Das ePOS-XML baut das Backend aus dem Zeichenraster (ein Setzweg).
- */
-export interface NetzDrucker {
-    id: string;
-    name: string;
-    art: string;
-    papier: 'mm58' | 'mm80';
-    aktiv: boolean;
-    erstellt: number | null;
-    /** Letzter Abruf des Druckers (ms); null = noch nie verbunden. */
-    zuletztGesehen: number | null;
-    zuletztErgebnis: {
-        erfolg: boolean;
-        code: string | null;
-        zeit: number;
-    } | null;
-    /** Kennung, die der Drucker selbst schickt (Feld ID im Drucker-Menue). */
-    druckerKennung: string | null;
-    /** Abhol-URL fuer das Drucker-Menue -- nur fuer den Chef/das Konto. */
-    sdpUrl?: string;
-}
-export type DruckJobStatus = 'offen' | 'gesendet' | 'gedruckt' | 'fehler' | 'abgelaufen';
-export interface DruckJob {
-    jobId: string;
-    status: DruckJobStatus;
-    erstellt?: number | null;
-    gesendetAt?: number | null;
-    ergebnis: {
-        erfolg: boolean;
-        code: string | null;
-        status?: string | null;
-        zeit?: number;
-    } | null;
-}
-export declare function listMyPrinters(rufen: InternerTransport): Promise<NetzDrucker[]>;
-export interface CreatePrintJobOptions {
-    druckerId: string;
-    layout: ReceiptLayout;
-    receiptId?: string;
-    titel?: string;
-    quelle?: string;
-    /** Firmenlogo als fertiges Rasterbild (`logoRaster`); der Server dekodiert keine Bilder. */
-    logo?: DruckLogo | null;
-    /** Das Kasseneck-Logo am Ende (Konto-Flag `kreiseck_logo`). */
-    marke?: boolean;
-}
-export declare function createPrintJob(rufen: InternerTransport, o: CreatePrintJobOptions): Promise<DruckJob>;
-export declare function getPrintJob(rufen: InternerTransport, o: {
-    druckerId: string;
-    jobId: string;
-}): Promise<DruckJob>;

package/dist/esm/kasse/drucker.js

@@ -1,45 +0,0 @@
-import { rasterZeilenBase64 } from '../printing/index.js';
-const text = (v) => (typeof v === 'string' && v ? v : null);
-const zahl = (v) => (typeof v === 'number' && Number.isFinite(v) ? v : null);
-export async function listMyPrinters(rufen) {
-    const daten = await rufen('listMyPrinters', {});
-    return (daten?.drucker ?? []).map((r) => {
-        const d = (r ?? {});
-        const e = d.zuletztErgebnis && typeof d.zuletztErgebnis === 'object' ? d.zuletztErgebnis : null;
-        return {
-            id: String(d.id ?? ''), name: String(d.name ?? ''), art: String(d.art ?? 'epson-sdp'), papier: d.papier === 'mm58' ? 'mm58' : 'mm80',
-            aktiv: d.aktiv !== false, erstellt: zahl(d.erstellt), zuletztGesehen: zahl(d.zuletztGesehen),
-            zuletztErgebnis: e ? { erfolg: e.erfolg === true, code: text(e.code), zeit: zahl(e.zeit) ?? 0 } : null,
-            druckerKennung: text(d.druckerKennung),
-            ...(text(d.sdpUrl) ? { sdpUrl: String(d.sdpUrl) } : {}),
-        };
-    });
-}
-export async function createPrintJob(rufen, o) {
-    const params = { druckerId: o.druckerId, layout: o.layout };
-    if (o.receiptId)
-        params.receiptId = o.receiptId;
-    if (o.titel)
-        params.titel = o.titel;
-    if (o.quelle)
-        params.quelle = o.quelle;
-    if (o.logo) {
-        params.logo = {
-            stufe: o.logo.stufe, pxBreite: o.logo.pxBreite, pxHoehe: o.logo.pxHoehe,
-            breite: o.logo.raster.breite, hoehe: o.logo.raster.hoehe, zeilen: rasterZeilenBase64(o.logo.raster),
-        };
-    }
-    if (o.marke === true)
-        params.marke = true;
-    const daten = await rufen('createPrintJob', params);
-    return { jobId: String(daten?.jobId ?? ''), status: text(daten?.status) ?? 'offen', ergebnis: null };
-}
-export async function getPrintJob(rufen, o) {
-    const d = await rufen('getPrintJob', { druckerId: o.druckerId, jobId: o.jobId });
-    const e = d?.ergebnis && typeof d.ergebnis === 'object' ? d.ergebnis : null;
-    return {
-        jobId: String(d?.jobId ?? o.jobId), status: text(d?.status) ?? 'offen',
-        erstellt: zahl(d?.erstellt), gesendetAt: zahl(d?.gesendetAt),
-        ergebnis: e ? { erfolg: e.erfolg === true, code: text(e.code), status: text(e.status), zeit: zahl(e.zeit) ?? undefined } : null,
-    };
-}

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

@@ -1,13 +0,0 @@
-/**
- * Kachel-Kasse: Einstellungen, Artikelgruppen/Artikel fuer Kacheln,
- * Rabattverteilung. Die Aufrufe heissen 1:1 wie die Backend-Functions
- * (die Rewrites-Waechter der Web-App leiten daraus ab).
- */
-export { type KasseStil, type KasseSchrift, type KasseWasserzeichen, type KasseMenge, type KasseTgModus, type KasseKassierenModus, type KasseKartenanbieter, KARTENANBIETER, type KasseBelegAusgabe, type KasseTastenAktion, type KasseTastenkarte, KASSE_TASTEN_AKTIONEN, KASSE_TASTEN_STANDARD, type KasseLayout, type KasseKatpos, type KasseHoehe, type KasseDruckerArt, type KasseTerminalVia, type KasseTerminalArt, type KassePapier, type KasseZeichensatz, type KasseSchnitt, type KasseLadeAuto, type KasseQrModus, type KasseLogoGroesse, type KasseSchriftEinst, type KasseKachelstil, type KasseAutoAbMin, type KasseRabatt, type KasseWzSeite, type KasseWzStaerke, type KasseLogoSkala, type KasseWzSkala, type KasseFertigSekunden, type Schalterkarte, type KasseSettingsBetrieb, type KasseSettingsGeraet, type KasseSettings, KASSE_BETRIEB_STANDARD, KASSE_GERAET_STANDARD, mergeKasseSettings, STIL, SCHRIFT, WASSERZEICHEN, MENGE, TG_MODUS, KASSIEREN_MODUS, BELEG_AUSGABE, LAYOUT, KATPOS, HOEHE, DRUCKER_ART, TERMINAL_VIA, TERMINAL_ART, PAPIER, ZEICHENSATZ, SCHNITT, LADE_AUTO, QR_MODUS, TASTEN_AKTIONEN, LOGO_GROESSE, SCHRIFT_EINST, KACHELSTIL, AUTO_AB_MIN, RABATT, WZ_SEITE, WZ_STAERKE, LOGO_SKALA, WZ_SKALA, FERTIG_SEKUNDEN, } from './settings.js';
-export { type ArticleGroup, type ArticleGroupPayload, fromArticleGroupPayload, type KasseArtikel, type KasseArtikelPayload, fromKasseArtikelPayload, listMyArticleGroups, listMyArticles, type Mengenregel, type MengenVorgabe, mengenregelFuerEinheit, mengenVorgabe, mengeErlaubt, } from './artikel.js';
-export { getKasseSettings, setMyKasseSettings, setMyRegisterDeviceSettings } from './client.js';
-export { verteileRabatt } from '../receipt/discount.js';
-export { cancelScopeOf, receiptsScopeOf, type RegisterScope, type RegisterUserPerms } from '../register/pairing.js';
-export { type NetzDrucker, type DruckJob, type DruckJobStatus, type CreatePrintJobOptions, listMyPrinters, createPrintJob, getPrintJob } from './drucker.js';
-export { listMyTipRecipients } from './trinkgeld.js';
-export { MELDUNGEN, FEHLERREGELN, meldung, meldungGiltFuer, BELEG_MAIL_FEHLER, belegMailFehler, STORNO_ZAHLUNG_FEHLER, stornoZahlungFehler, BESCHRIFTUNGEN, beschriftung, type Meldung, type MeldungsSchluessel, type Fehlerart, type Seite, type BelegMailFehlercode, type StornoZahlungFehlercode, type BeschriftungsSchluessel, } from './texte.js';

package/dist/esm/kasse/index.js

@@ -1,18 +0,0 @@
-/**
- * Kachel-Kasse: Einstellungen, Artikelgruppen/Artikel fuer Kacheln,
- * Rabattverteilung. Die Aufrufe heissen 1:1 wie die Backend-Functions
- * (die Rewrites-Waechter der Web-App leiten daraus ab).
- */
-export { KARTENANBIETER, KASSE_TASTEN_AKTIONEN, KASSE_TASTEN_STANDARD, KASSE_BETRIEB_STANDARD, KASSE_GERAET_STANDARD, mergeKasseSettings, 
-// Die Enums als Laufzeitlisten — dieselben Werte, die die Typen oben tragen.
-STIL, SCHRIFT, WASSERZEICHEN, MENGE, TG_MODUS, KASSIEREN_MODUS, BELEG_AUSGABE, LAYOUT, KATPOS, HOEHE, DRUCKER_ART, TERMINAL_VIA, TERMINAL_ART, PAPIER, ZEICHENSATZ, SCHNITT, LADE_AUTO, QR_MODUS, TASTEN_AKTIONEN, LOGO_GROESSE, SCHRIFT_EINST, KACHELSTIL, AUTO_AB_MIN, RABATT, WZ_SEITE, WZ_STAERKE, LOGO_SKALA, WZ_SKALA, FERTIG_SEKUNDEN, } from './settings.js';
-export { fromArticleGroupPayload, fromKasseArtikelPayload, listMyArticleGroups, listMyArticles, mengenregelFuerEinheit, mengenVorgabe, mengeErlaubt, } from './artikel.js';
-export { getKasseSettings, setMyKasseSettings, setMyRegisterDeviceSettings } from './client.js';
-export { verteileRabatt } from '../receipt/discount.js';
-// Reichweiten der Kassen-Rechte (Migration wie im Backend) -- bewusst NICHT im
-// Register-Unterpfad: dessen Exportnamen sind 1:1 Function-Namen (Rewrites).
-export { cancelScopeOf, receiptsScopeOf } from '../register/pairing.js';
-export { listMyPrinters, createPrintJob, getPrintJob } from './drucker.js';
-export { listMyTipRecipients } from './trinkgeld.js';
-// Was die Kasse selbst sagt — ein Katalog fuer Browser-Kasse und App.
-export { MELDUNGEN, FEHLERREGELN, meldung, meldungGiltFuer, BELEG_MAIL_FEHLER, belegMailFehler, STORNO_ZAHLUNG_FEHLER, stornoZahlungFehler, BESCHRIFTUNGEN, beschriftung, } from './texte.js';

package/dist/esm/kasse/settings.d.ts

@@ -1,229 +0,0 @@
-/**
- * Kassen-Einstellungen der Browser-Kasse — Zwilling von
- * `functions/kasse-settings-core.js` (Backend, dort mit Validator).
- *
- * Betriebsweit (`register_settings.kasse` am Konto) und je Geraet
- * (`register_devices/{id}.kasse`). Die Standardwerte stehen hier UND im
- * Backend; ein Test in beiden Repos haelt sie deckungsgleich. Trinkgeld ist
- * bewusst AUS, bis die Buchung geklaert ist (Spec kachel-kasse § 9).
- */
-export declare const STIL: readonly ["klar", "warm", "nacht", "kontrast"];
-export type KasseStil = typeof STIL[number];
-export declare const SCHRIFT: readonly ["S", "M", "L", "XL"];
-export type KasseSchrift = typeof SCHRIFT[number];
-export declare const WASSERZEICHEN: readonly ["aus", "anmeldung", "ueberall"];
-export type KasseWasserzeichen = typeof WASSERZEICHEN[number];
-export declare const MENGE: readonly ["aus", "x", "kg"];
-export type KasseMenge = typeof MENGE[number];
-export declare const TG_MODUS: readonly ["betrag", "gesamt", "beides"];
-export type KasseTgModus = typeof TG_MODUS[number];
-export declare const KASSIEREN_MODUS: readonly ["seite", "panel"];
-export type KasseKassierenModus = typeof KASSIEREN_MODUS[number];
-/** Kartenanbieter: Karte gibt es erst mit eingerichtetem Anbieter; 'extern' = eigenes Terminal ohne Anbindung. */
-export declare const KARTENANBIETER: readonly ["keiner", "extern", "gptom", "hobex", "mypos", "stripe"];
-export type KasseKartenanbieter = typeof KARTENANBIETER[number];
-export declare const BELEG_AUSGABE: readonly ["qr", "druck", "mail", "sms", "fragen"];
-export type KasseBelegAusgabe = typeof BELEG_AUSGABE[number];
-export declare const LAYOUT: readonly ["rechts", "links", "vollbild"];
-export type KasseLayout = typeof LAYOUT[number];
-export declare const KATPOS: readonly ["oben", "links"];
-export type KasseKatpos = typeof KATPOS[number];
-export declare const HOEHE: readonly ["S", "M", "L"];
-export type KasseHoehe = typeof HOEHE[number];
-/**
- * `sdp` = Netzwerk ueber Epson Server Direct Print (der Drucker holt Jobs vom Backend, jeder Browser druckt).
- * `connect` = Kasseneck Connect (lokaler Agent auf dem Kassen-Rechner druckt fuer die Browser-Kasse).
- */
-export declare const DRUCKER_ART: readonly ["sdp", "netz", "bt", "usb", "connect"];
-export type KasseDruckerArt = typeof DRUCKER_ART[number];
-/** Terminal-Ansprache: direkt per IP (wie bisher) oder ueber Kasseneck Connect (Agent leitet weiter). */
-export declare const TERMINAL_VIA: readonly ["direkt", "connect"];
-export type KasseTerminalVia = typeof TERMINAL_VIA[number];
-/** Art des Kartenterminals an dieser Kasse: keines oder Hobex HPS (JSON-REST am Geraet). */
-export declare const TERMINAL_ART: readonly ["keins", "hps"];
-export type KasseTerminalArt = typeof TERMINAL_ART[number];
-export declare const PAPIER: readonly ["mm58", "mm80"];
-export type KassePapier = typeof PAPIER[number];
-export declare const ZEICHENSATZ: readonly ["CP1252", "CP437"];
-export type KasseZeichensatz = typeof ZEICHENSATZ[number];
-export declare const SCHNITT: readonly ["partial", "full", "none"];
-export type KasseSchnitt = typeof SCHNITT[number];
-export declare const LADE_AUTO: readonly ["bar", "immer", "nie"];
-export type KasseLadeAuto = typeof LADE_AUTO[number];
-/**
- * Mit welchem Befehl der Signatur-QR auf den Bon kommt.
- *
- * `raster` = der QR wird als Bild gerastert (GS v 0) und geht darum durch jeden
- * Drucker, der Bilder kann. `escpos` = der native QR-Befehl (GS ( k) — schaerfer
- * und schneller, aber aeltere Geraete drucken dann gar keinen QR oder
- * Zeichensalat.
- *
- * `auto` ist die Vorgabe und heisst **unbestimmt**: an diesem Geraet hat noch
- * niemand am Papier entschieden. Jede Kasse bleibt dann bei ihrer bisherigen
- * Praxis — die Browser-Kasse beim ESC/POS-Befehl, die App beim Rasterbild.
- * Eine harte Vorgabe waere hier eine stille Umstellung des Altbestands
- * gewesen: jedes Geraet, das nie durch den Drucker-Wizard lief, druckte
- * ploetzlich anders, und ueber BLE kostet ein Rasterbild mehrere Sekunden je
- * Bon. Nur ein ausdruecklich gesetzter Wert aendert etwas.
- *
- * **Eine Geraete-Einstellung, keine des Betriebs:** derselbe Bon kommt an einer
- * Kasse sauber heraus und an der Nebenkasse nicht. Und sie ist nicht
- * kosmetisch — nach § 132a BAO ist der QR Teil des Belegs; wer den falschen
- * Modus stehen laesst, erteilt Belege ohne lesbare Signatur.
- */
-export declare const QR_MODUS: readonly ["auto", "raster", "escpos"];
-export type KasseQrModus = typeof QR_MODUS[number];
-/** Groesse des Kuerzel-Logos in der Kopfzeile der Kasse. */
-export declare const LOGO_GROESSE: readonly ["S", "M", "L"];
-export type KasseLogoGroesse = typeof LOGO_GROESSE[number];
-/** Schriftgroesse in den Chef-Einstellungen — getrennt von der Schrift der Kasse. */
-export declare const SCHRIFT_EINST: readonly ["S", "M", "L"];
-export type KasseSchriftEinst = typeof SCHRIFT_EINST[number];
-/** Kachel-Optik: farbiger Streifen am Rand oder ganz gefuellte Kachel. */
-export declare const KACHELSTIL: readonly ["streifen", "voll"];
-export type KasseKachelstil = typeof KACHELSTIL[number];
-/** Automatisches Abmelden nach Minuten Ruhe; 0 = nie. */
-export declare const AUTO_AB_MIN: readonly [0, 1, 5, 15, 30];
-export type KasseAutoAbMin = typeof AUTO_AB_MIN[number];
-/** Rabatt am Beleg erlaubt. */
-export declare const RABATT: readonly ["aus", "an"];
-export type KasseRabatt = typeof RABATT[number];
-/** Seite des Wasserzeichens — ALT, abgeloest von wzPos. */
-export declare const WZ_SEITE: readonly ["links", "mitte", "rechts"];
-export type KasseWzSeite = typeof WZ_SEITE[number];
-/** Deckkraft des Wasserzeichens in Prozent — bewusst Stufen, kein Schieberegler. */
-export declare const WZ_STAERKE: readonly [3, 6, 10, 16];
-export type KasseWzStaerke = typeof WZ_STAERKE[number];
-/** Groesse des Bild-Logos am Beleg. */
-export declare const LOGO_SKALA: readonly ["S", "M", "L", "XL"];
-export type KasseLogoSkala = typeof LOGO_SKALA[number];
-/** Groesse des Wasserzeichens — getrennt vom Beleg-Logo. */
-export declare const WZ_SKALA: readonly ["S", "M", "L", "XL"];
-export type KasseWzSkala = typeof WZ_SKALA[number];
-/** Wie lange die Fertig-Seite stehen bleibt, in Sekunden; 0 = bis zum Tippen. */
-export declare const FERTIG_SEKUNDEN: readonly [0, 3, 5, 10, 15, 30, 60];
-export type KasseFertigSekunden = typeof FERTIG_SEKUNDEN[number];
-/** Schalter-Landkarte: Steuersaetze / Trinkgeldstufen (Schluessel = Wert als Text). */
-export type Schalterkarte = Record<string, boolean>;
-export interface KasseSettingsBetrieb {
-    logoText: string;
-    logoAn: boolean;
-    logoGroesse: KasseLogoGroesse;
-    wasserzeichen: KasseWasserzeichen;
-    farbe: string;
-    stil: KasseStil;
-    schrift: KasseSchrift;
-    schriftEinst: KasseSchriftEinst;
-    kachelstil: KasseKachelstil;
-    uhr: boolean;
-    sperrbild: boolean;
-    foto: boolean;
-    autoAbMin: KasseAutoAbMin;
-    abNachVerkauf: boolean;
-    /** Schnelles Entsperren mit gemerkter PIN (lokal, Server-Login laeuft nach); aus = streng, jeder Login wartet. */
-    schnellLogin: boolean;
-    preisAnzeigen: boolean;
-    ustAnzeigen: boolean;
-    emoji: boolean;
-    katFarben: boolean;
-    freiErlaubt: boolean;
-    saetze: Schalterkarte;
-    menge: KasseMenge;
-    notiz: boolean;
-    suche: boolean;
-    rabatt: KasseRabatt;
-    /** Bild-Logo (Download-URL aus dem Kasse-Upload); '' = Kuerzel verwenden. */
-    logoBild: string;
-    /** Seite des Wasserzeichens — ALT: abgeloest von wzPos, bleibt fuers Mischen alter Staende. */
-    wzSeite: KasseWzSeite;
-    /** Horizontale Lage der Wasserzeichen-MITTE in Prozent (-25 bis 125 — darf ueber den Rand hinaus). */
-    wzPos: number;
-    /** Vertikale Lage der Wasserzeichen-Mitte in Prozent (-25 bis 125). */
-    wzPosV: number;
-    /** Deckkraft des Wasserzeichens in Prozent — bewusst Stufen, kein Schieberegler. */
-    wzStaerke: KasseWzStaerke;
-    /** Groesse des Bild-Logos am BELEG (Ansicht, PDF, Kopfzeile). */
-    logoSkala: KasseLogoSkala;
-    /** Groesse des Wasserzeichens — getrennt vom Beleg-Logo. */
-    wzSkala: KasseWzSkala;
-    zahlBar: boolean;
-    zahlKarte: boolean;
-    kartenanbieter: KasseKartenanbieter;
-    trinkgeld: boolean;
-    tgModus: KasseTgModus;
-    tgStufen: Schalterkarte;
-    tgSplit: boolean;
-    rueckgeld: boolean;
-    schnellbar: boolean;
-    kassierenModus: KasseKassierenModus;
-    /** Getrennt zahlen: dritter Knopf neben Bar und Karte, ein Beleg mit mehreren Zahlungen. */
-    zahlGetrennt: boolean;
-    /** Trinkgeld-Chips in Prozent (eine Nachkommastelle, max 5, eindeutig, Reihenfolge des Chefs). */
-    tgChips: number[];
-    /** Rabatt-Chips in Prozent — dieselben Regeln wie tgChips, vom Chef einstellbar. */
-    rabattChips: number[];
-    belegAusgabe: KasseBelegAusgabe;
-    fertigSekunden: KasseFertigSekunden;
-    /** Glas-Optik: Kacheln und Korb leicht durchscheinend (Wasserzeichen schimmert). */
-    glas: boolean;
-    /** Hilfetexte in den Chef-Einstellungen anzeigen. */
-    hinweise: boolean;
-}
-/** Aktionen der Kasse, die eine Taste bekommen koennen. */
-export declare const KASSE_TASTEN_AKTIONEN: readonly ["kassieren", "abschliessen", "abbrechen", "frei", "bar", "karte", "passend", "belege", "letzteZurueck", "einstellungen", "abmelden", "trinkgeld", "vollbild", "gegebenLeeren", "korbLeeren", "getrennt"];
-export type KasseTastenAktion = typeof KASSE_TASTEN_AKTIONEN[number];
-/** Kurzer Name, damit alle Enum-Listen gleich heissen; der alte bleibt gueltig. */
-export declare const TASTEN_AKTIONEN: readonly ["kassieren", "abschliessen", "abbrechen", "frei", "bar", "karte", "passend", "belege", "letzteZurueck", "einstellungen", "abmelden", "trinkgeld", "vollbild", "gegebenLeeren", "korbLeeren", "getrennt"];
-/** Tastenkarte: Aktion -> Tasten (`Mod+F`, `Enter`, `Escape`, `F5` ...; `Mod` = ⌘ auf dem Mac, Strg sonst). */
-export type KasseTastenkarte = Record<KasseTastenAktion, string[]>;
-export declare const KASSE_TASTEN_STANDARD: Readonly<KasseTastenkarte>;
-export interface KasseSettingsGeraet {
-    layout: KasseLayout;
-    katpos: KasseKatpos;
-    spaltenExtra: number;
-    hoehe: KasseHoehe;
-    touch: boolean;
-    /** Tastenbelegung dieses Geraets (Vorgabe KASSE_TASTEN_STANDARD, je Aktion mischbar). */
-    tasten: KasseTastenkarte;
-    druckerAn: boolean;
-    druckerArt: KasseDruckerArt;
-    druckerIp: string;
-    druckerPort: number;
-    druckerBt: string;
-    /** Klartextname des gemerkten Druckers; sonst stuende dort eine nackte Bluetooth-Adresse. */
-    druckerName: string;
-    /** Kennung des Netzwerk-Druckers (Server Direct Print) aus `listMyPrinters`; '' = keiner gewaehlt. */
-    druckerId: string;
-    /** ePOS Device-ID bei `druckerArt 'netz'` (Epson direkt per IP), Vorgabe `local_printer`. */
-    druckerDevid: string;
-    /** Kennung des Druckers im lokalen Kasseneck-Connect-Agenten, bei `druckerArt 'connect'`. */
-    connectDruckerId: string;
-    papier: KassePapier;
-    zeichensatz: KasseZeichensatz;
-    schnitt: KasseSchnitt;
-    /** Befehl fuer den Signatur-QR auf dem Bon; 'auto' = unbestimmt, der Drucker-Wizard probiert beide aus. */
-    qrModus: KasseQrModus;
-    ladeAn: boolean;
-    ladeAuto: KasseLadeAuto;
-    terminalIp: string;
-    terminalPort: number;
-    terminalVia: KasseTerminalVia;
-    /** Art des Terminals ('keins' = Kartenzahlung ohne Terminal-Anbindung gesperrt, sofern zahlKarte an). */
-    terminalArt: KasseTerminalArt;
-    /** Tastenmarken (die kleinen Kuerzel an den Knoepfen) anzeigen. */
-    tastenMarken: boolean;
-    /** Terminal-ID aus dem Hobex-Vertrag (ohne fuehrende Null); noetig fuer Diagnose und Zahlung. */
-    terminalTid: string;
-}
-export interface KasseSettings {
-    betrieb: KasseSettingsBetrieb;
-    geraet: KasseSettingsGeraet;
-}
-export declare const KASSE_BETRIEB_STANDARD: Readonly<KasseSettingsBetrieb>;
-export declare const KASSE_GERAET_STANDARD: Readonly<KasseSettingsGeraet>;
-/**
- * Standard + gespeichert. Landkarten (`saetze`, `tgStufen`) werden je Schluessel
- * gemischt, damit neue Saetze beim Altbestand ankommen; unbekannte Schluessel
- * bleiben draussen (die Wahrheit ueber Gueltigkeit hat der Server).
- */
-export declare function mergeKasseSettings<T extends object>(standard: Readonly<T>, gespeichert: Partial<T> | null | undefined): T;

package/dist/esm/kasse/settings.js

@@ -1,168 +0,0 @@
-/**
- * Kassen-Einstellungen der Browser-Kasse — Zwilling von
- * `functions/kasse-settings-core.js` (Backend, dort mit Validator).
- *
- * Betriebsweit (`register_settings.kasse` am Konto) und je Geraet
- * (`register_devices/{id}.kasse`). Die Standardwerte stehen hier UND im
- * Backend; ein Test in beiden Repos haelt sie deckungsgleich. Trinkgeld ist
- * bewusst AUS, bis die Buchung geklaert ist (Spec kachel-kasse § 9).
- */
-/*
- * Jedes Enum steht als Liste zur Laufzeit da, der Typ leitet sich daraus ab
- * (`typeof LISTE[number]`). So gibt es die Werte nur einmal, und die Zwillinge
- * (Backend-Validator, Flutter-Paket) koennen gegen dieselben Listen pruefen,
- * statt sie abzuschreiben.
- */
-export const STIL = ['klar', 'warm', 'nacht', 'kontrast'];
-export const SCHRIFT = ['S', 'M', 'L', 'XL'];
-export const WASSERZEICHEN = ['aus', 'anmeldung', 'ueberall'];
-export const MENGE = ['aus', 'x', 'kg'];
-export const TG_MODUS = ['betrag', 'gesamt', 'beides'];
-export const KASSIEREN_MODUS = ['seite', 'panel'];
-/** Kartenanbieter: Karte gibt es erst mit eingerichtetem Anbieter; 'extern' = eigenes Terminal ohne Anbindung. */
-export const KARTENANBIETER = ['keiner', 'extern', 'gptom', 'hobex', 'mypos', 'stripe'];
-export const BELEG_AUSGABE = ['qr', 'druck', 'mail', 'sms', 'fragen'];
-export const LAYOUT = ['rechts', 'links', 'vollbild'];
-export const KATPOS = ['oben', 'links'];
-export const HOEHE = ['S', 'M', 'L'];
-/**
- * `sdp` = Netzwerk ueber Epson Server Direct Print (der Drucker holt Jobs vom Backend, jeder Browser druckt).
- * `connect` = Kasseneck Connect (lokaler Agent auf dem Kassen-Rechner druckt fuer die Browser-Kasse).
- */
-export const DRUCKER_ART = ['sdp', 'netz', 'bt', 'usb', 'connect'];
-/** Terminal-Ansprache: direkt per IP (wie bisher) oder ueber Kasseneck Connect (Agent leitet weiter). */
-export const TERMINAL_VIA = ['direkt', 'connect'];
-/** Art des Kartenterminals an dieser Kasse: keines oder Hobex HPS (JSON-REST am Geraet). */
-export const TERMINAL_ART = ['keins', 'hps'];
-export const PAPIER = ['mm58', 'mm80'];
-export const ZEICHENSATZ = ['CP1252', 'CP437'];
-export const SCHNITT = ['partial', 'full', 'none'];
-export const LADE_AUTO = ['bar', 'immer', 'nie'];
-/**
- * Mit welchem Befehl der Signatur-QR auf den Bon kommt.
- *
- * `raster` = der QR wird als Bild gerastert (GS v 0) und geht darum durch jeden
- * Drucker, der Bilder kann. `escpos` = der native QR-Befehl (GS ( k) — schaerfer
- * und schneller, aber aeltere Geraete drucken dann gar keinen QR oder
- * Zeichensalat.
- *
- * `auto` ist die Vorgabe und heisst **unbestimmt**: an diesem Geraet hat noch
- * niemand am Papier entschieden. Jede Kasse bleibt dann bei ihrer bisherigen
- * Praxis — die Browser-Kasse beim ESC/POS-Befehl, die App beim Rasterbild.
- * Eine harte Vorgabe waere hier eine stille Umstellung des Altbestands
- * gewesen: jedes Geraet, das nie durch den Drucker-Wizard lief, druckte
- * ploetzlich anders, und ueber BLE kostet ein Rasterbild mehrere Sekunden je
- * Bon. Nur ein ausdruecklich gesetzter Wert aendert etwas.
- *
- * **Eine Geraete-Einstellung, keine des Betriebs:** derselbe Bon kommt an einer
- * Kasse sauber heraus und an der Nebenkasse nicht. Und sie ist nicht
- * kosmetisch — nach § 132a BAO ist der QR Teil des Belegs; wer den falschen
- * Modus stehen laesst, erteilt Belege ohne lesbare Signatur.
- */
-export const QR_MODUS = ['auto', 'raster', 'escpos'];
-/*
- * Auch die uebrigen Wertemengen der Einstellungen stehen jetzt als Liste da —
- * vorher waren sie nur als Union am Feld ausgeschrieben. Ein Zwilling konnte
- * dadurch einen Wert (etwa `kachelstil: 'voll'`) gar nicht kennen, ohne dass es
- * auffiel: der Vertrag fuehrte die Menge nicht, und die Standardwerte-Datei
- * pinnt je Feld nur einen einzigen Wert.
- */
-/** Groesse des Kuerzel-Logos in der Kopfzeile der Kasse. */
-export const LOGO_GROESSE = ['S', 'M', 'L'];
-/** Schriftgroesse in den Chef-Einstellungen — getrennt von der Schrift der Kasse. */
-export const SCHRIFT_EINST = ['S', 'M', 'L'];
-/** Kachel-Optik: farbiger Streifen am Rand oder ganz gefuellte Kachel. */
-export const KACHELSTIL = ['streifen', 'voll'];
-/** Automatisches Abmelden nach Minuten Ruhe; 0 = nie. */
-export const AUTO_AB_MIN = [0, 1, 5, 15, 30];
-/** Rabatt am Beleg erlaubt. */
-export const RABATT = ['aus', 'an'];
-/** Seite des Wasserzeichens — ALT, abgeloest von wzPos. */
-export const WZ_SEITE = ['links', 'mitte', 'rechts'];
-/** Deckkraft des Wasserzeichens in Prozent — bewusst Stufen, kein Schieberegler. */
-export const WZ_STAERKE = [3, 6, 10, 16];
-/** Groesse des Bild-Logos am Beleg. */
-export const LOGO_SKALA = ['S', 'M', 'L', 'XL'];
-/** Groesse des Wasserzeichens — getrennt vom Beleg-Logo. */
-export const WZ_SKALA = ['S', 'M', 'L', 'XL'];
-/** Wie lange die Fertig-Seite stehen bleibt, in Sekunden; 0 = bis zum Tippen. */
-export const FERTIG_SEKUNDEN = [0, 3, 5, 10, 15, 30, 60];
-/** Aktionen der Kasse, die eine Taste bekommen koennen. */
-export const KASSE_TASTEN_AKTIONEN = ['kassieren', 'abschliessen', 'abbrechen', 'frei', 'bar', 'karte', 'passend', 'belege', 'letzteZurueck', 'einstellungen', 'abmelden', 'trinkgeld', 'vollbild', 'gegebenLeeren', 'korbLeeren', 'getrennt'];
-/** Kurzer Name, damit alle Enum-Listen gleich heissen; der alte bleibt gueltig. */
-export const TASTEN_AKTIONEN = KASSE_TASTEN_AKTIONEN;
-export const KASSE_TASTEN_STANDARD = Object.freeze({
-    kassieren: ['Enter'], abschliessen: ['Enter'], abbrechen: ['Escape'],
-    // Mod+F gehoert dem Vollbild; Betrag frei liegt auf D. Bar bleibt auf B,
-    // Belege auf E (Entscheidung vom 21.8., der Tausch von 0.6.25 ist zurueck).
-    frei: ['Mod+D'], bar: ['Mod+B'], karte: ['Mod+K'], passend: ['Mod+P'],
-    // NICHT Mod+E: das faengt Chrome auf dem Mac selbst ab („Auswahl fuer
-    // Suche verwenden") — am Geraet belegt. J wie Journal laesst er durch.
-    belege: ['Mod+J'], letzteZurueck: ['Mod+Backspace'],
-    // NICHT Mod+T: die Taste ist im Browser reserviert (neuer Tab) und kommt
-    // nie bei der Seite an. Mod+G laesst Chrome durch.
-    einstellungen: ['Mod+S'], abmelden: ['Mod+L'], trinkgeld: ['Mod+G'],
-    vollbild: ['Mod+F'],
-    // Mod+C = Kopieren des Browsers — im Kassieren-Schritt ist Kopieren fern,
-    // und die Bindung gilt nur dort (Bar + Rueckgeld-Rechner an).
-    gegebenLeeren: ['Mod+C'],
-    // Bewusst DIESELBE Taste wie gegebenLeeren: die beiden leben in
-    // verschiedenen Momenten (Korb vor dem Kassieren, Gegeben-Feld darin) —
-    // der Verteiler laesst die nicht zustaendige Aktion durchfallen.
-    korbLeeren: ['Mod+C'],
-    // Bewusst ohne Vorgabe: jede freie Mod-Taste ist in irgendeinem Browser
-    // belegt oder am Geraet unerprobt. Der Chef vergibt sie, wenn er sie braucht.
-    getrennt: [],
-});
-export const KASSE_BETRIEB_STANDARD = Object.freeze({
-    // Das Petrol der Marke: die Aktionsfarbe des Design-Systems (Rolle `brand`).
-    // Stand bis September 2026 auf dem Wert des alten Markenhandbuchs,
-    // der um 0,07 in OKLab danebenlag. Unsichtbar, aber es war die letzte Stelle
-    // im Haus, an der eine zweite Zahl fuer dieselbe Farbe stand.
-    logoText: 'K', logoAn: true, logoGroesse: 'M', wasserzeichen: 'anmeldung', farbe: '#136B6B',
-    stil: 'klar', schrift: 'M', schriftEinst: 'S', kachelstil: 'streifen', uhr: true,
-    sperrbild: true, foto: true, autoAbMin: 0, abNachVerkauf: false, schnellLogin: true,
-    preisAnzeigen: true, ustAnzeigen: false, emoji: true, katFarben: true, freiErlaubt: true,
-    saetze: { 20: true, 13: true, 10: true, 4.9: true, 0: true, 19: false },
-    menge: 'x', notiz: false, suche: false, rabatt: 'aus',
-    zahlBar: true, zahlKarte: false, kartenanbieter: 'keiner', trinkgeld: false, tgModus: 'beides',
-    tgStufen: { 5: true, 10: true, 15: false, 20: false }, tgChips: [5, 10], tgSplit: true, rueckgeld: true,
-    schnellbar: false, kassierenModus: 'panel', zahlGetrennt: false,
-    // 'fragen' = Fertig-Seite bietet QR und Bon an — sicherster Standard.
-    logoBild: '', wzSeite: 'mitte', wzPos: 50, wzPosV: 50, wzStaerke: 6, logoSkala: 'M', wzSkala: 'M',
-    glas: true, hinweise: true,
-    rabattChips: [5, 10, 15, 20],
-    belegAusgabe: 'fragen', fertigSekunden: 0,
-});
-export const KASSE_GERAET_STANDARD = Object.freeze({
-    layout: 'rechts', katpos: 'oben', spaltenExtra: 0, hoehe: 'M', touch: false,
-    tasten: { ...KASSE_TASTEN_STANDARD },
-    druckerAn: false, druckerArt: 'sdp', druckerIp: '', druckerPort: 9100, druckerBt: '', druckerName: '', druckerId: '', druckerDevid: 'local_printer',
-    connectDruckerId: '',
-    papier: 'mm80', zeichensatz: 'CP1252', schnitt: 'partial', qrModus: 'auto',
-    ladeAn: false, ladeAuto: 'bar',
-    terminalIp: '', terminalPort: 8080, terminalVia: 'direkt',
-    terminalArt: 'keins', terminalTid: '', tastenMarken: true,
-});
-/**
- * Standard + gespeichert. Landkarten (`saetze`, `tgStufen`) werden je Schluessel
- * gemischt, damit neue Saetze beim Altbestand ankommen; unbekannte Schluessel
- * bleiben draussen (die Wahrheit ueber Gueltigkeit hat der Server).
- */
-export function mergeKasseSettings(standard, gespeichert) {
-    const out = JSON.parse(JSON.stringify(standard));
-    if (gespeichert && typeof gespeichert === 'object') {
-        for (const [key, wert] of Object.entries(gespeichert)) {
-            if (!(key in out))
-                continue;
-            const alt = out[key];
-            if (alt && typeof alt === 'object' && !Array.isArray(alt) && wert && typeof wert === 'object' && !Array.isArray(wert)) {
-                out[key] = { ...alt, ...wert };
-            }
-            else if (wert !== undefined) {
-                out[key] = wert;
-            }
-        }
-    }
-    return out;
-}