@kreiseck/kasseneck-api 0.6.7

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

@@ -0,0 +1,21 @@
+import { type Cashregister } from '../models/index.js';
+import type { KasseneckTransport } from './transport.js';
+/**
+ * Kassen-Endpunkte.
+ *
+ * **Anmeldeweg:** `listMyCashregisters` laeuft im Backend unter
+ * `checkRequest(req, 'customer', …, {allowRegisterUser: true})` — der Bearer
+ * muss also ein Firebase-ID-Token sein. Mit `apiKeyAuth` (api_key als Bearer)
+ * ist dieser Endpunkt **nicht** erreichbar; fuer die Browser-Kasse ist
+ * `registerUserAuth` der Weg. Dieses Paket bildet das nicht nach — wer darf,
+ * entscheidet allein das Backend. Der Hinweis steht hier, damit ein Leser
+ * nicht raten muss.
+ */
+/**
+ * Die Kassen, die dem angemeldeten Benutzer offenstehen — fuer einen
+ * Kassen-Benutzer genau die ihm zugewiesenen (das Backend filtert, siehe
+ * `registerAuth.darfKasse`).
+ *
+ * Ohne diesen Aufruf kann eine Browser-Kasse ihre Kasse nicht auswaehlen.
+ */
+export declare function listMyCashregisters(rufen: KasseneckTransport): Promise<Cashregister[]>;

package/dist/cjs/client/cashregisters.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listMyCashregisters = listMyCashregisters;
+const index_js_1 = require("../models/index.js");
+const errors_js_1 = require("./errors.js");
+/**
+ * Kassen-Endpunkte.
+ *
+ * **Anmeldeweg:** `listMyCashregisters` laeuft im Backend unter
+ * `checkRequest(req, 'customer', …, {allowRegisterUser: true})` — der Bearer
+ * muss also ein Firebase-ID-Token sein. Mit `apiKeyAuth` (api_key als Bearer)
+ * ist dieser Endpunkt **nicht** erreichbar; fuer die Browser-Kasse ist
+ * `registerUserAuth` der Weg. Dieses Paket bildet das nicht nach — wer darf,
+ * entscheidet allein das Backend. Der Hinweis steht hier, damit ein Leser
+ * nicht raten muss.
+ */
+/**
+ * Die Kassen, die dem angemeldeten Benutzer offenstehen — fuer einen
+ * Kassen-Benutzer genau die ihm zugewiesenen (das Backend filtert, siehe
+ * `registerAuth.darfKasse`).
+ *
+ * Ohne diesen Aufruf kann eine Browser-Kasse ihre Kasse nicht auswaehlen.
+ */
+async function listMyCashregisters(rufen) {
+    const daten = await rufen('listMyCashregisters');
+    const liste = daten?.cashregisters;
+    if (!Array.isArray(liste)) {
+        throw new errors_js_1.KasseneckValidationError('listMyCashregisters', 'Antwort enthaelt keine Kassenliste (data.cashregisters fehlt)', 'response');
+    }
+    return liste.map((eintrag, i) => {
+        const nutzlast = (typeof eintrag === 'object' && eintrag !== null ? eintrag : {});
+        // Die Dokument-ID steht in dieser Antwort im Eintrag selbst; der zweite
+        // Parameter ist nur der Rueckfall (siehe fromCashregisterPayload).
+        return (0, index_js_1.fromCashregisterPayload)(nutzlast, nutzlast.id ?? String(i));
+    });
+}

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

@@ -0,0 +1,159 @@
+/**
+ * Die fuenf Fehlerarten des Kasseneck-Clients — bewusst getrennt, weil ein
+ * Aufrufer auf jede anders reagieren muss:
+ *
+ * - `KasseneckValidationError` — die **Form** stimmt nicht: entweder ging
+ *   mangels brauchbarer Eingabe gar keine Anfrage raus, oder die Antwort war
+ *   nicht verwertbar. `scope` trennt die beiden Richtungen. `'request'`: die
+ *   Eingabe des Aufrufers verletzt eine Regel, die dieses Paket schon vor dem
+ *   Senden kennt (Beleg ohne Positionen, unmoegliche Gutscheinkombination) —
+ *   das ist ein Programmierfehler im Aufrufer, kein Betriebszustand.
+ *   `'response'`: das Backend meldete Erfolg, die Nutzlast enthielt aber
+ *   nicht, was der Aufruf zusagt.
+ *
+ * - `KasseneckApiError` — **fachlicher** Fehler. Das Backend antwortet immer
+ *   mit HTTP 200 und legt Erfolg/Misserfolg in den Rumpf
+ *   (`{status:'success'|'error', message, data}`, siehe `successResponse`/
+ *   `errorResponse` im Backend). Ein `status:'error'` heisst: die Anfrage kam
+ *   an und wurde abgelehnt (gesperrte Kasse, fehlendes Modul, ungueltiger
+ *   Parameter). Wiederholen hilft nicht.
+ * - `KasseneckHttpError` — die Antwort war **keine** verwertbare Huelle:
+ *   HTTP 500/404, leerer Rumpf, oder HTTP 200 mit HTML statt JSON (typisch,
+ *   wenn ein Aufruf mangels Rewrite auf der Single-Page-App landet). Beim
+ *   Bericht-Download gelten dieselben Gruende fuer alles, was kein PDF ist.
+ *   `reason` trennt die Faelle maschinenlesbar.
+ * - `KasseneckNetworkError` — die Antwort kam gar nicht: Netz weg, DNS,
+ *   abgebrochene Verbindung oder Zeitueberschreitung (`timedOut`).
+ * - `KasseneckAuthError` — es kam nicht einmal zur Anfrage, weil die Anmeldung
+ *   scheiterte (fehlende Zugangsdaten, oder der Token-/Sitzungsgeber warf).
+ *   In der Browser-Kasse mit ihrer 90-Sekunden-Sitzung ist das Alltag, kein
+ *   Sonderfall.
+ *
+ * **Geheimnisse gehoeren in keinen dieser Fehler.** Fehlermeldungen landen in
+ * Protokollen und Fehlerdiensten; weder `api_key`, Kassen-Token, Firebase-
+ * ID-Token noch Sitzungsbezeichner duerfen dorthin. Deshalb tragen die Fehler
+ * ausschliesslich Funktionsname, HTTP-Status/Inhaltstyp, den vom Paket
+ * formulierten Grund und die vom Backend formulierte Meldung — nie Kopfzeilen,
+ * nie den gesendeten Rumpf und auch nicht den empfangenen Rumpf (der koennte
+ * bei einem fremden Proxy alles Moegliche zurueckspiegeln).
+ *
+ * Aus demselben Grund haengt **keine fremde Ursache** als `cause` an diesen
+ * Fehlern: `console.error(err)` und `util.inspect` drucken die Ursachenkette
+ * mit, und fremde HTTP-Bibliotheken haengen ihre Anfrage an ihre Fehler (axios
+ * `config.headers`, got `options.headers`) — mit dem Bearer-Schluessel darin.
+ * Statt der Ursache selbst traegt `KasseneckNetworkError` ihre **verdichtete**
+ * Form: `causeName`/`causeCode`, beide nur, wenn sie wie ein Bezeichner
+ * aussehen **und** mit keinem der gesendeten Geheimnisse ueberlappen (siehe
+ * `causeDigest`).
+ *
+ * Der Formfilter allein traegt diese Zusage naemlich nicht: der
+ * Sitzungsbezeichner der Browser-Kasse ist selbst bezeichner-foermig und kaeme
+ * durch. Verdichtet werden darf nur, wo die gesendeten Geheimnisse bekannt
+ * sind — also nach dem Bauen der Anfrage. `KasseneckAuthError` traegt darum
+ * **gar keine** Ursachen-Verdichtung: dort ist noch nichts gesendet, es gibt
+ * keine Liste zum Abgleichen, und Diagnose ist an dieser Stelle weniger wert
+ * als die Zusage.
+ */
+/** Verdichtete, geheimnisfreie Form einer fremden Fehlerursache. */
+export interface CauseDigest {
+    causeName?: string | undefined;
+    causeCode?: string | undefined;
+}
+/**
+ * Reduziert eine fremde Ursache auf Name und Code — und verwirft beides, wenn
+ * es kein Bezeichner ist oder mit einem der uebergebenen Geheimnisse
+ * ueberlappt (ein Sitzungsbezeichner sieht durchaus bezeichner-artig aus).
+ *
+ * `geheimnisse` hat bewusst **keinen** Vorgabewert: eine Verdichtung ohne
+ * Abgleichliste waere nur ein Formfilter und damit keine Zusage. Wo die
+ * gesendeten Werte nicht bekannt sind, wird gar nicht verdichtet.
+ */
+export declare function causeDigest(ursache: unknown, geheimnisse: readonly string[]): CauseDigest;
+/** Fachlicher Fehler: HTTP 200, aber `status: 'error'` im Rumpf. */
+export declare class KasseneckApiError extends Error {
+    readonly name = "KasseneckApiError";
+    /** Aufgerufene Backend-Funktion, z. B. `createReceipt`. */
+    readonly functionName: string;
+    /** Meldung des Backends, unveraendert (`message` aus der Huelle). */
+    readonly serverMessage: string;
+    constructor(functionName: string, serverMessage: string);
+}
+/** Warum die Antwort keine verwertbare Huelle war. */
+export type HttpFailureReason = 'server-error' | 'empty-body' | 'not-json' | 'missing-status';
+/** Antwort ohne verwertbare Huelle (HTTP-Fehler, leerer Rumpf, HTML statt JSON). */
+export declare class KasseneckHttpError extends Error {
+    readonly name = "KasseneckHttpError";
+    readonly functionName: string;
+    /** HTTP-Statuscode der Antwort (bei HTML-statt-JSON durchaus 200). */
+    readonly statusCode: number;
+    /** Inhaltstyp der Antwort, falls die Gegenstelle einen gesetzt hat. */
+    readonly contentType: string | undefined;
+    /** Maschinenlesbarer Grund — trennt den Rewrite-Fall vom 500er ohne Textparsen. */
+    readonly reason: HttpFailureReason;
+    constructor(functionName: string, statusCode: number, contentType: string | undefined, reason: HttpFailureReason);
+}
+/** Es kam keine Antwort: Netzfehler oder Zeitueberschreitung. */
+export declare class KasseneckNetworkError extends Error {
+    readonly name = "KasseneckNetworkError";
+    readonly functionName: string;
+    /** true = das Zeitlimit lief ab und die Anfrage wurde abgebrochen. */
+    readonly timedOut: boolean;
+    /** Das geltende Zeitlimit in Millisekunden. */
+    readonly timeoutMs: number;
+    /** Name der zugrunde liegenden Ursache, sofern unbedenklich (s. `causeDigest`). */
+    readonly causeName: string | undefined;
+    /** Code der zugrunde liegenden Ursache, sofern unbedenklich (z. B. `ECONNREFUSED`). */
+    readonly causeCode: string | undefined;
+    constructor(functionName: string, timedOut: boolean, timeoutMs: number, ursache?: CauseDigest);
+}
+/**
+ * Die Anmeldung scheiterte — es ging keine Anfrage raus.
+ *
+ * Dieser Fehler traegt **nichts** aus der fremden Ursache: weder ihre Meldung
+ * (ein Token-Geber fuehrt gern den Token mit, den er gerade nicht erneuern
+ * konnte) noch eine Verdichtung ihres Namens/Codes. Zum Zeitpunkt des
+ * Anmeldefehlers ist noch nichts gesendet, es gibt also keine Liste der
+ * Geheimnisse, gegen die verdichtete Werte geprueft werden koennten — und ein
+ * reiner Formfilter laesst genau die Form durch, die ein Sitzungsbezeichner
+ * hat.
+ */
+export declare class KasseneckAuthError extends Error {
+    readonly name = "KasseneckAuthError";
+    /** Betroffene Backend-Funktion, falls der Fehler bei einem Aufruf entstand. */
+    readonly functionName: string | undefined;
+    /** Vom Paket formulierter Grund — geheimnisfrei, anders als fremde Meldungen. */
+    readonly reason: string;
+    constructor(reason: string, options?: {
+        functionName?: string;
+    });
+}
+/** Woran die Form haengt: an der Eingabe des Aufrufers oder an der Antwort. */
+export type ValidationScope = 'request' | 'response';
+/**
+ * Die Form stimmt nicht — bei `scope: 'request'` ging deshalb keine Anfrage
+ * raus, bei `scope: 'response'` kam eine unbrauchbare zurueck.
+ *
+ * Es gilt dieselbe Zusage wie fuer die uebrigen Fehlerarten: `reason` ist vom
+ * Paket formuliert und geheimnisfrei. Bei `'response'` wird insbesondere
+ * **nichts aus der Antwort** uebernommen — ein fremder Proxy koennte dort
+ * alles Moegliche zurueckspiegeln.
+ */
+export declare class KasseneckValidationError extends Error {
+    readonly name = "KasseneckValidationError";
+    /**
+     * Betroffener Vorgang — meist die Backend-Funktion, bei Pruefungen ohne
+     * Aufruf der Name der Paketfunktion (z. B. `buildReceiptLayout`).
+     */
+    readonly functionName: string;
+    /** Vom Paket formulierter Grund. */
+    readonly reason: string;
+    readonly scope: ValidationScope;
+    constructor(functionName: string, reason: string, scope: ValidationScope);
+}
+/** Alle Fehler, die dieses Paket wirft. */
+export type KasseneckError = KasseneckApiError | KasseneckHttpError | KasseneckNetworkError | KasseneckAuthError | KasseneckValidationError;
+export declare function isKasseneckApiError(fehler: unknown): fehler is KasseneckApiError;
+export declare function isKasseneckHttpError(fehler: unknown): fehler is KasseneckHttpError;
+export declare function isKasseneckNetworkError(fehler: unknown): fehler is KasseneckNetworkError;
+export declare function isKasseneckAuthError(fehler: unknown): fehler is KasseneckAuthError;
+export declare function isKasseneckValidationError(fehler: unknown): fehler is KasseneckValidationError;

package/dist/cjs/client/errors.js

@@ -0,0 +1,226 @@
+"use strict";
+/**
+ * Die fuenf Fehlerarten des Kasseneck-Clients — bewusst getrennt, weil ein
+ * Aufrufer auf jede anders reagieren muss:
+ *
+ * - `KasseneckValidationError` — die **Form** stimmt nicht: entweder ging
+ *   mangels brauchbarer Eingabe gar keine Anfrage raus, oder die Antwort war
+ *   nicht verwertbar. `scope` trennt die beiden Richtungen. `'request'`: die
+ *   Eingabe des Aufrufers verletzt eine Regel, die dieses Paket schon vor dem
+ *   Senden kennt (Beleg ohne Positionen, unmoegliche Gutscheinkombination) —
+ *   das ist ein Programmierfehler im Aufrufer, kein Betriebszustand.
+ *   `'response'`: das Backend meldete Erfolg, die Nutzlast enthielt aber
+ *   nicht, was der Aufruf zusagt.
+ *
+ * - `KasseneckApiError` — **fachlicher** Fehler. Das Backend antwortet immer
+ *   mit HTTP 200 und legt Erfolg/Misserfolg in den Rumpf
+ *   (`{status:'success'|'error', message, data}`, siehe `successResponse`/
+ *   `errorResponse` im Backend). Ein `status:'error'` heisst: die Anfrage kam
+ *   an und wurde abgelehnt (gesperrte Kasse, fehlendes Modul, ungueltiger
+ *   Parameter). Wiederholen hilft nicht.
+ * - `KasseneckHttpError` — die Antwort war **keine** verwertbare Huelle:
+ *   HTTP 500/404, leerer Rumpf, oder HTTP 200 mit HTML statt JSON (typisch,
+ *   wenn ein Aufruf mangels Rewrite auf der Single-Page-App landet). Beim
+ *   Bericht-Download gelten dieselben Gruende fuer alles, was kein PDF ist.
+ *   `reason` trennt die Faelle maschinenlesbar.
+ * - `KasseneckNetworkError` — die Antwort kam gar nicht: Netz weg, DNS,
+ *   abgebrochene Verbindung oder Zeitueberschreitung (`timedOut`).
+ * - `KasseneckAuthError` — es kam nicht einmal zur Anfrage, weil die Anmeldung
+ *   scheiterte (fehlende Zugangsdaten, oder der Token-/Sitzungsgeber warf).
+ *   In der Browser-Kasse mit ihrer 90-Sekunden-Sitzung ist das Alltag, kein
+ *   Sonderfall.
+ *
+ * **Geheimnisse gehoeren in keinen dieser Fehler.** Fehlermeldungen landen in
+ * Protokollen und Fehlerdiensten; weder `api_key`, Kassen-Token, Firebase-
+ * ID-Token noch Sitzungsbezeichner duerfen dorthin. Deshalb tragen die Fehler
+ * ausschliesslich Funktionsname, HTTP-Status/Inhaltstyp, den vom Paket
+ * formulierten Grund und die vom Backend formulierte Meldung — nie Kopfzeilen,
+ * nie den gesendeten Rumpf und auch nicht den empfangenen Rumpf (der koennte
+ * bei einem fremden Proxy alles Moegliche zurueckspiegeln).
+ *
+ * Aus demselben Grund haengt **keine fremde Ursache** als `cause` an diesen
+ * Fehlern: `console.error(err)` und `util.inspect` drucken die Ursachenkette
+ * mit, und fremde HTTP-Bibliotheken haengen ihre Anfrage an ihre Fehler (axios
+ * `config.headers`, got `options.headers`) — mit dem Bearer-Schluessel darin.
+ * Statt der Ursache selbst traegt `KasseneckNetworkError` ihre **verdichtete**
+ * Form: `causeName`/`causeCode`, beide nur, wenn sie wie ein Bezeichner
+ * aussehen **und** mit keinem der gesendeten Geheimnisse ueberlappen (siehe
+ * `causeDigest`).
+ *
+ * Der Formfilter allein traegt diese Zusage naemlich nicht: der
+ * Sitzungsbezeichner der Browser-Kasse ist selbst bezeichner-foermig und kaeme
+ * durch. Verdichtet werden darf nur, wo die gesendeten Geheimnisse bekannt
+ * sind — also nach dem Bauen der Anfrage. `KasseneckAuthError` traegt darum
+ * **gar keine** Ursachen-Verdichtung: dort ist noch nichts gesendet, es gibt
+ * keine Liste zum Abgleichen, und Diagnose ist an dieser Stelle weniger wert
+ * als die Zusage.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KasseneckValidationError = exports.KasseneckAuthError = exports.KasseneckNetworkError = exports.KasseneckHttpError = exports.KasseneckApiError = void 0;
+exports.causeDigest = causeDigest;
+exports.isKasseneckApiError = isKasseneckApiError;
+exports.isKasseneckHttpError = isKasseneckHttpError;
+exports.isKasseneckNetworkError = isKasseneckNetworkError;
+exports.isKasseneckAuthError = isKasseneckAuthError;
+exports.isKasseneckValidationError = isKasseneckValidationError;
+// Bezeichner-artig: Buchstabe vorn, danach nur Bezeichnerzeichen, hoechstens
+// 64 Zeichen. Das laesst `TypeError`, `ECONNREFUSED` und `auth/internal-error`
+// durch, aber keinen Freitext und kein Firebase-ID-Token (~900 Zeichen).
+const BEZEICHNER = /^[A-Za-z][A-Za-z0-9_./-]{0,63}$/;
+/**
+ * Reduziert eine fremde Ursache auf Name und Code — und verwirft beides, wenn
+ * es kein Bezeichner ist oder mit einem der uebergebenen Geheimnisse
+ * ueberlappt (ein Sitzungsbezeichner sieht durchaus bezeichner-artig aus).
+ *
+ * `geheimnisse` hat bewusst **keinen** Vorgabewert: eine Verdichtung ohne
+ * Abgleichliste waere nur ein Formfilter und damit keine Zusage. Wo die
+ * gesendeten Werte nicht bekannt sind, wird gar nicht verdichtet.
+ */
+function causeDigest(ursache, geheimnisse) {
+    const roh = ursache;
+    return {
+        causeName: unbedenklich(roh?.name, geheimnisse),
+        causeCode: unbedenklich(roh?.code, geheimnisse),
+    };
+}
+function unbedenklich(wert, geheimnisse) {
+    if (typeof wert !== 'string' || !BEZEICHNER.test(wert)) {
+        return undefined;
+    }
+    for (const geheim of geheimnisse) {
+        if (geheim && (geheim.includes(wert) || wert.includes(geheim))) {
+            return undefined;
+        }
+    }
+    return wert;
+}
+/** Fachlicher Fehler: HTTP 200, aber `status: 'error'` im Rumpf. */
+class KasseneckApiError extends Error {
+    name = 'KasseneckApiError';
+    /** Aufgerufene Backend-Funktion, z. B. `createReceipt`. */
+    functionName;
+    /** Meldung des Backends, unveraendert (`message` aus der Huelle). */
+    serverMessage;
+    constructor(functionName, serverMessage) {
+        super(`${functionName} fehlgeschlagen: ${serverMessage}`);
+        this.functionName = functionName;
+        this.serverMessage = serverMessage;
+    }
+}
+exports.KasseneckApiError = KasseneckApiError;
+const GRUND_TEXT = {
+    'server-error': 'Server-Fehler',
+    'empty-body': 'leere Antwort',
+    'not-json': 'Antwort ist kein JSON',
+    'missing-status': 'Antwort ohne Statusfeld',
+};
+/** Antwort ohne verwertbare Huelle (HTTP-Fehler, leerer Rumpf, HTML statt JSON). */
+class KasseneckHttpError extends Error {
+    name = 'KasseneckHttpError';
+    functionName;
+    /** HTTP-Statuscode der Antwort (bei HTML-statt-JSON durchaus 200). */
+    statusCode;
+    /** Inhaltstyp der Antwort, falls die Gegenstelle einen gesetzt hat. */
+    contentType;
+    /** Maschinenlesbarer Grund — trennt den Rewrite-Fall vom 500er ohne Textparsen. */
+    reason;
+    constructor(functionName, statusCode, contentType, reason) {
+        const typHinweis = contentType ? `, Inhaltstyp ${contentType}` : '';
+        super(`${functionName} fehlgeschlagen: ${GRUND_TEXT[reason]} (HTTP ${statusCode}${typHinweis})`);
+        this.functionName = functionName;
+        this.statusCode = statusCode;
+        this.contentType = contentType;
+        this.reason = reason;
+    }
+}
+exports.KasseneckHttpError = KasseneckHttpError;
+/** Es kam keine Antwort: Netzfehler oder Zeitueberschreitung. */
+class KasseneckNetworkError extends Error {
+    name = 'KasseneckNetworkError';
+    functionName;
+    /** true = das Zeitlimit lief ab und die Anfrage wurde abgebrochen. */
+    timedOut;
+    /** Das geltende Zeitlimit in Millisekunden. */
+    timeoutMs;
+    /** Name der zugrunde liegenden Ursache, sofern unbedenklich (s. `causeDigest`). */
+    causeName;
+    /** Code der zugrunde liegenden Ursache, sofern unbedenklich (z. B. `ECONNREFUSED`). */
+    causeCode;
+    constructor(functionName, timedOut, timeoutMs, ursache = {}) {
+        const grund = timedOut ? `Zeitueberschreitung nach ${timeoutMs} ms` : 'Netzwerkfehler';
+        const codeHinweis = ursache.causeCode ? ` (${ursache.causeCode})` : '';
+        super(`${functionName} fehlgeschlagen: ${grund}${codeHinweis}`);
+        this.functionName = functionName;
+        this.timedOut = timedOut;
+        this.timeoutMs = timeoutMs;
+        this.causeName = ursache.causeName;
+        this.causeCode = ursache.causeCode;
+    }
+}
+exports.KasseneckNetworkError = KasseneckNetworkError;
+/**
+ * Die Anmeldung scheiterte — es ging keine Anfrage raus.
+ *
+ * Dieser Fehler traegt **nichts** aus der fremden Ursache: weder ihre Meldung
+ * (ein Token-Geber fuehrt gern den Token mit, den er gerade nicht erneuern
+ * konnte) noch eine Verdichtung ihres Namens/Codes. Zum Zeitpunkt des
+ * Anmeldefehlers ist noch nichts gesendet, es gibt also keine Liste der
+ * Geheimnisse, gegen die verdichtete Werte geprueft werden koennten — und ein
+ * reiner Formfilter laesst genau die Form durch, die ein Sitzungsbezeichner
+ * hat.
+ */
+class KasseneckAuthError extends Error {
+    name = 'KasseneckAuthError';
+    /** Betroffene Backend-Funktion, falls der Fehler bei einem Aufruf entstand. */
+    functionName;
+    /** Vom Paket formulierter Grund — geheimnisfrei, anders als fremde Meldungen. */
+    reason;
+    constructor(reason, options = {}) {
+        super(options.functionName ? `${options.functionName} fehlgeschlagen: ${reason}` : reason);
+        this.functionName = options.functionName;
+        this.reason = reason;
+    }
+}
+exports.KasseneckAuthError = KasseneckAuthError;
+/**
+ * Die Form stimmt nicht — bei `scope: 'request'` ging deshalb keine Anfrage
+ * raus, bei `scope: 'response'` kam eine unbrauchbare zurueck.
+ *
+ * Es gilt dieselbe Zusage wie fuer die uebrigen Fehlerarten: `reason` ist vom
+ * Paket formuliert und geheimnisfrei. Bei `'response'` wird insbesondere
+ * **nichts aus der Antwort** uebernommen — ein fremder Proxy koennte dort
+ * alles Moegliche zurueckspiegeln.
+ */
+class KasseneckValidationError extends Error {
+    name = 'KasseneckValidationError';
+    /**
+     * Betroffener Vorgang — meist die Backend-Funktion, bei Pruefungen ohne
+     * Aufruf der Name der Paketfunktion (z. B. `buildReceiptLayout`).
+     */
+    functionName;
+    /** Vom Paket formulierter Grund. */
+    reason;
+    scope;
+    constructor(functionName, reason, scope) {
+        super(`${functionName} fehlgeschlagen: ${reason}`);
+        this.functionName = functionName;
+        this.reason = reason;
+        this.scope = scope;
+    }
+}
+exports.KasseneckValidationError = KasseneckValidationError;
+function isKasseneckApiError(fehler) {
+    return fehler instanceof KasseneckApiError;
+}
+function isKasseneckHttpError(fehler) {
+    return fehler instanceof KasseneckHttpError;
+}
+function isKasseneckNetworkError(fehler) {
+    return fehler instanceof KasseneckNetworkError;
+}
+function isKasseneckAuthError(fehler) {
+    return fehler instanceof KasseneckAuthError;
+}
+function isKasseneckValidationError(fehler) {
+    return fehler instanceof KasseneckValidationError;
+}

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

@@ -0,0 +1,8 @@
+export { type AuthCredentials, type KasseneckAuth, type ApiKeyAuthOptions, type RegisterUserAuthOptions, apiKeyAuth, registerUserAuth, } from './auth.js';
+export { DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, type HttpResponseLike, type HttpRequestInit, type FetchLike, type TransportOptions, type TransportBodyFields, type KasseneckTransport, type KasseneckBinaryTransport, createTransport, createBinaryTransport, } from './transport.js';
+export { KasseneckApiError, KasseneckAuthError, KasseneckHttpError, KasseneckNetworkError, KasseneckValidationError, type ValidationScope, type KasseneckError, type HttpFailureReason, type CauseDigest, isKasseneckApiError, isKasseneckAuthError, isKasseneckHttpError, isKasseneckNetworkError, isKasseneckValidationError, } from './errors.js';
+export { type ReceiptCommonOptions, type SellReceiptOptions, type CancelReceiptOptions, type CreateCancelReceiptOptions, type ReceiptWithCompany, sellReceipt, sellReceiptWithCompany, cancelReceipt, type CancelReceiptResult, createCancelReceipt, zeroReceipt, getReceipt, getReceiptWithCompany, generateFullReceiptId, getFirstReceiptDate, listMyReceipts, type ListMyReceiptsOptions, type ReceiptList, type ReceiptListStats, checkVoucherCombinationError, } from './receipts.js';
+export { listMyCashregisters } from './cashregisters.js';
+export { downloadDailyReport, downloadMonthlyReport } from './reports.js';
+export { type CashboxStatus, type SignatureStatus, getCashboxStatus, getSignatureStatus, } from './status.js';
+export { type KasseneckApi, createKasseneckApi } from './api.js';

package/dist/cjs/client/index.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createKasseneckApi = exports.getSignatureStatus = exports.getCashboxStatus = exports.downloadMonthlyReport = exports.downloadDailyReport = exports.listMyCashregisters = exports.checkVoucherCombinationError = exports.listMyReceipts = exports.getFirstReceiptDate = exports.generateFullReceiptId = exports.getReceiptWithCompany = exports.getReceipt = exports.zeroReceipt = exports.createCancelReceipt = exports.cancelReceipt = exports.sellReceiptWithCompany = exports.sellReceipt = exports.isKasseneckValidationError = exports.isKasseneckNetworkError = exports.isKasseneckHttpError = exports.isKasseneckAuthError = exports.isKasseneckApiError = exports.KasseneckValidationError = exports.KasseneckNetworkError = exports.KasseneckHttpError = exports.KasseneckAuthError = exports.KasseneckApiError = exports.createBinaryTransport = exports.createTransport = exports.DEFAULT_TIMEOUT_MS = exports.DEFAULT_BASE_URL = exports.registerUserAuth = exports.apiKeyAuth = void 0;
+var auth_js_1 = require("./auth.js");
+Object.defineProperty(exports, "apiKeyAuth", { enumerable: true, get: function () { return auth_js_1.apiKeyAuth; } });
+Object.defineProperty(exports, "registerUserAuth", { enumerable: true, get: function () { return auth_js_1.registerUserAuth; } });
+var transport_js_1 = require("./transport.js");
+Object.defineProperty(exports, "DEFAULT_BASE_URL", { enumerable: true, get: function () { return transport_js_1.DEFAULT_BASE_URL; } });
+Object.defineProperty(exports, "DEFAULT_TIMEOUT_MS", { enumerable: true, get: function () { return transport_js_1.DEFAULT_TIMEOUT_MS; } });
+Object.defineProperty(exports, "createTransport", { enumerable: true, get: function () { return transport_js_1.createTransport; } });
+Object.defineProperty(exports, "createBinaryTransport", { enumerable: true, get: function () { return transport_js_1.createBinaryTransport; } });
+var errors_js_1 = require("./errors.js");
+Object.defineProperty(exports, "KasseneckApiError", { enumerable: true, get: function () { return errors_js_1.KasseneckApiError; } });
+Object.defineProperty(exports, "KasseneckAuthError", { enumerable: true, get: function () { return errors_js_1.KasseneckAuthError; } });
+Object.defineProperty(exports, "KasseneckHttpError", { enumerable: true, get: function () { return errors_js_1.KasseneckHttpError; } });
+Object.defineProperty(exports, "KasseneckNetworkError", { enumerable: true, get: function () { return errors_js_1.KasseneckNetworkError; } });
+Object.defineProperty(exports, "KasseneckValidationError", { enumerable: true, get: function () { return errors_js_1.KasseneckValidationError; } });
+Object.defineProperty(exports, "isKasseneckApiError", { enumerable: true, get: function () { return errors_js_1.isKasseneckApiError; } });
+Object.defineProperty(exports, "isKasseneckAuthError", { enumerable: true, get: function () { return errors_js_1.isKasseneckAuthError; } });
+Object.defineProperty(exports, "isKasseneckHttpError", { enumerable: true, get: function () { return errors_js_1.isKasseneckHttpError; } });
+Object.defineProperty(exports, "isKasseneckNetworkError", { enumerable: true, get: function () { return errors_js_1.isKasseneckNetworkError; } });
+Object.defineProperty(exports, "isKasseneckValidationError", { enumerable: true, get: function () { return errors_js_1.isKasseneckValidationError; } });
+var receipts_js_1 = require("./receipts.js");
+Object.defineProperty(exports, "sellReceipt", { enumerable: true, get: function () { return receipts_js_1.sellReceipt; } });
+Object.defineProperty(exports, "sellReceiptWithCompany", { enumerable: true, get: function () { return receipts_js_1.sellReceiptWithCompany; } });
+Object.defineProperty(exports, "cancelReceipt", { enumerable: true, get: function () { return receipts_js_1.cancelReceipt; } });
+Object.defineProperty(exports, "createCancelReceipt", { enumerable: true, get: function () { return receipts_js_1.createCancelReceipt; } });
+Object.defineProperty(exports, "zeroReceipt", { enumerable: true, get: function () { return receipts_js_1.zeroReceipt; } });
+Object.defineProperty(exports, "getReceipt", { enumerable: true, get: function () { return receipts_js_1.getReceipt; } });
+Object.defineProperty(exports, "getReceiptWithCompany", { enumerable: true, get: function () { return receipts_js_1.getReceiptWithCompany; } });
+Object.defineProperty(exports, "generateFullReceiptId", { enumerable: true, get: function () { return receipts_js_1.generateFullReceiptId; } });
+Object.defineProperty(exports, "getFirstReceiptDate", { enumerable: true, get: function () { return receipts_js_1.getFirstReceiptDate; } });
+Object.defineProperty(exports, "listMyReceipts", { enumerable: true, get: function () { return receipts_js_1.listMyReceipts; } });
+Object.defineProperty(exports, "checkVoucherCombinationError", { enumerable: true, get: function () { return receipts_js_1.checkVoucherCombinationError; } });
+var cashregisters_js_1 = require("./cashregisters.js");
+Object.defineProperty(exports, "listMyCashregisters", { enumerable: true, get: function () { return cashregisters_js_1.listMyCashregisters; } });
+var reports_js_1 = require("./reports.js");
+Object.defineProperty(exports, "downloadDailyReport", { enumerable: true, get: function () { return reports_js_1.downloadDailyReport; } });
+Object.defineProperty(exports, "downloadMonthlyReport", { enumerable: true, get: function () { return reports_js_1.downloadMonthlyReport; } });
+var status_js_1 = require("./status.js");
+Object.defineProperty(exports, "getCashboxStatus", { enumerable: true, get: function () { return status_js_1.getCashboxStatus; } });
+Object.defineProperty(exports, "getSignatureStatus", { enumerable: true, get: function () { return status_js_1.getSignatureStatus; } });
+var api_js_1 = require("./api.js");
+Object.defineProperty(exports, "createKasseneckApi", { enumerable: true, get: function () { return api_js_1.createKasseneckApi; } });