Change overLimitWhenIncremented to return an object with limiting information instead of Boolean

[tandel-pratik]

Context

Often many APIs that use rate limiting return the number of remaining calls using headers like X-RateLimit-Remaining. It would be ideal for the interfaces to return an object that contains additional information like number of calls remaining and when the limit will be reset. This makes it easier for clients to deal with the rate limits in a better way.