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", "action_confirmation_required", "admin_required", "api_not_approved", "app_check_invalid", "app_check_missing", "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", "password_change_required", "register_user_no_business", "register_user_not_allowed", "register_user_not_found", "register_user_only", "response_translation_failed", "second_factor_required", "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[];