/**
 * Error codes for Keycloak-related errors
 */
export declare const ErrorCodes: {
    readonly INIT_FAILED: "KC_INIT_1000";
    readonly SERVER_UNREACHABLE: "KC_INIT_1001";
    readonly INVALID_CONFIG: "KC_INIT_1002";
    readonly REALM_NOT_FOUND: "KC_INIT_1003";
    readonly CLIENT_NOT_FOUND: "KC_INIT_1004";
    readonly AUTH_FAILED: "KC_AUTH_2000";
    readonly LOGIN_REQUIRED: "KC_AUTH_2001";
    readonly INVALID_CREDENTIALS: "KC_AUTH_2002";
    readonly ACCOUNT_LOCKED: "KC_AUTH_2003";
    readonly SESSION_EXPIRED: "KC_AUTH_2004";
    readonly TOKEN_REFRESH_FAILED: "KC_TOKEN_3000";
    readonly TOKEN_EXPIRED: "KC_TOKEN_3001";
    readonly INVALID_TOKEN: "KC_TOKEN_3002";
    readonly REFRESH_TOKEN_EXPIRED: "KC_TOKEN_3003";
    readonly NETWORK_ERROR: "KC_NET_4000";
    readonly TIMEOUT: "KC_NET_4001";
    readonly CORS_ERROR: "KC_NET_4002";
    readonly MISSING_URL: "KC_CONFIG_5000";
    readonly MISSING_REALM: "KC_CONFIG_5001";
    readonly MISSING_CLIENT_ID: "KC_CONFIG_5002";
    readonly INVALID_REDIRECT_URI: "KC_CONFIG_5003";
};
export type ErrorCode = typeof ErrorCodes[keyof typeof ErrorCodes];
/**
 * Base error class for all Keycloak-related errors
 */
export declare class KeycloakError extends Error {
    readonly code: string;
    readonly recoverable: boolean;
    readonly cause?: unknown | undefined;
    constructor(message: string, code: string, recoverable?: boolean, cause?: unknown | undefined);
    /**
     * User-friendly message suitable for display
     */
    get userMessage(): string;
    /**
     * Suggested action for recovery
     */
    get suggestedAction(): string | null;
    /**
     * Convert to JSON for logging/serialization
     */
    toJSON(): {
        name: string;
        message: string;
        code: string;
        recoverable: boolean;
        userMessage: string;
        suggestedAction: string | null;
        cause: unknown;
    };
}
/**
 * Initialization errors (server unreachable, invalid config, etc.)
 */
export declare class KeycloakInitError extends KeycloakError {
    constructor(message: string, code: string, cause?: unknown);
}
/**
 * Authentication errors (login failed, invalid credentials, etc.)
 */
export declare class KeycloakAuthError extends KeycloakError {
    constructor(message: string, code: string, cause?: unknown);
}
/**
 * Token refresh errors (expired refresh token, network issues, etc.)
 */
export declare class KeycloakTokenError extends KeycloakError {
    constructor(message: string, code: string, cause?: unknown);
}
/**
 * Configuration errors (missing required params, invalid values, etc.)
 */
export declare class KeycloakConfigError extends KeycloakError {
    constructor(message: string, code: string);
}
/**
 * Network errors (timeout, connection refused, etc.)
 */
export declare class KeycloakNetworkError extends KeycloakError {
    constructor(message: string, code: string, cause?: unknown);
}
/**
 * Helper function to wrap unknown errors into typed Keycloak errors
 */
export declare function wrapError(error: unknown, defaultCode: ErrorCode): KeycloakError;
/**
 * Check if an error is a configuration error (non-recoverable)
 */
export declare function isConfigError(error: unknown): boolean;
/**
 * Check if an error is a network error (recoverable with retry)
 */
export declare function isNetworkError(error: unknown): boolean;
//# sourceMappingURL=keycloak-errors.d.ts.map