Not enough information in exception when Rate Limiting is encountered

[philomory]

Description

When rate limiting is encountered, an Auth0::Unsupported exception is raised, whose message only states {"statusCode":429,"error":"Too Many Requests"}. This is because the exception message is generated from only the HTTP response's status and body.

When the Auth0 API returns a 429 response, it includes details about the limits in HTTP response headers; specifically, as noted in Rate Limits, the X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers.

It would be good to return this information to the caller when raising an exception due to rate limiting.

Prerequisites

• I have read the Auth0 general contribution guidelines
• I have read the Auth0 Code of Conduct
• Did you check the documentation (repo README or Quickstart)?
• Did you check the Auth0 Community?
• Are you reporting this to the correct repository? See also the OmniAuth-Auth0 strategy for logging in with Rails.
• Are there any related or duplicate Issues or PRs for this issue?

Environment

Please provide the following:

• Ruby Auth0 version: 4.6.0
• Ruby version: 2.4.4
• Rails version (if applicable): N/A
• Browser version (if applicable): N/A
• Additional gems that might be affecting your instance: N/A

Reproduction

Easiest way to reproduce is to use a free/trial account with a low rate limit, and then repeatedly call Auth0::Api::V2#logs until an exception is raised.

[philomory]

Actually, it might be generally a good idea to make all of the exceptions that Auth0::Mixins::HTTPProxy can raise, inherit from a common Auth0::HTTPError, and provide access to either the RestClient::ExceptionWithResponse or at least the RestClient::Response object in addition to the normal message.

[joshcanhelp]

@philomory - Apologies for not responding any sooner here, I don't recall getting a notification for this.

Thank you for the report here and digging into a potential solution. I'll see if I can get a good solution in place ahead of our next release.

[joshcanhelp]

Fixed in #170