ErrorMessageExtractor

15class ErrorMessageExtractor16{17    /**18     * Extracts error message from API response data.19     *20     * Handles common error response formats:21     * - { "error": { "message": "Error text" } }22     * - { "error": "Error text" }23     * - { "message": "Error text" }24     *25     * @since 0.2.026     *27     * @param mixed $data The response data to extract error message from.28     * @return string|null The extracted error message, or null if none found.29     */30    public static function extractFromResponseData($data): ?string31    {32        if (!is_array($data)) {33            return null;34        }35        // Handle [ { "error": { "message": "Error text" } } ]36        if (isset($data[0]) && is_array($data[0]) && isset($data[0]['error']) && is_array($data[0]['error']) && isset($data[0]['error']['message']) && is_string($data[0]['error']['message'])) {37            return $data[0]['error']['message'];38        }39        // Handle { "error": { "message": "Error text" } }40        if (isset($data['error']) && is_array($data['error']) && isset($data['error']['message']) && is_string($data['error']['message'])) {41            return $data['error']['message'];42        }43        // Handle { "error": "Error text" }44        if (isset($data['error']) && is_string($data['error'])) {45            return $data['error'];46        }47        // Handle { "message": "Error text" }48        if (isset($data['message']) && is_string($data['message'])) {49            return $data['message'];50        }51        return null;52    }53}