/** * Utilities for extracting error messages from API responses. * * @module clients/error-utils */ /** * Extract a clean error message from an API error response. * * Handles multiple API error patterns and falls back to HTTP status. * This ensures that HTML response bodies (like error pages) are never * included in user-facing error messages. * * Supported error patterns: * - ODS/SLAS: `{ error: { message: '...' } }` * - OCAPI: `{ fault: { message: '...' } }` * - SCAPI/Problem+JSON: `{ detail: '...', title: '...' }` * - Standard Error: `{ message: '...' }` * * @param error - The error object from an API response * @param response - The HTTP response (for status code fallback) * @returns A clean, human-readable error message * * @example * ```typescript * const {data, error, response} = await client.GET('/sites', {...}); * if (error) { * const message = getApiErrorMessage(error, response); * // Returns structured error message or "HTTP 521 Web Server Is Down" * } * ``` */ export declare function getApiErrorMessage(error: unknown, response: Response | { status: number; statusText: string; }): string;