Expose response data in Authenticator.refresh(_:for:completion:)

[antiraum]

• I've read, understood, and done my best to follow the *CONTRIBUTING guidelines.

Problem

Our API doesn't use an additional HTTP header to indicate authentication failure, but instead has error codes in the JSON response body. Therefore we must decode and evaluate the DataRequest.data in Authenticator.refresh(_:for:completion:).

Feature Request

The simplest solution would be to change

Authenticator.didRequest(_ urlRequest: URLRequest, with response: HTTPURLResponse, failDueToAuthenticationError error: Error) -> Bool

to

Authenticator.didRequest(_ request: Request, failDueToAuthenticationError error: Error) -> Bool

There is probably a better/non-breaking approach.

Value to Alamofire

Accommodate a broader variety of API authentication implementations.

[jshier]

Probably a good idea. We likely don't want to expose the Request directly, as there are types which won't have available Data, but some method of making it visible would be a good idea.