Add extra options to withAuthenticationRequired

[adamjmcgrath]

Description

There are some cases where just the location.pathname is not enough information for the user to be returned to the url they were redirected to the login page from. eg hashrouting

Allow the returnTo param to be customised as a string or a method to handle these cases, eg for hash routing:

// A typical hash route will look like http://localhost:3000/#/users
withAuthenticationRequired(Users, {
  returnTo: () => window.location.hash.substr(1) // '/users'
})

Also allow the user to pass RedirectLoginOptions to loginWithRedirect in case they want to add additional appState

References

auth0-samples/auth0-vue-samples#100 (A Vue example, but the same applies to React)
https://reacttraining.com/react-router/web/api/HashRouter

Testing

• This change adds test coverage for new/changed/fixed functionality

Checklist

• I have added documentation for new/changed functionality in this PR or in auth0.com/docs
• All active GitHub checks for tests, formatting, and security are passing
• The correct base branch is being used, if not master