feat: Add support for custom refresh handling

[blumewas]

🔗 Linked issue

Issue #714

❓ Type of change

• 📖 Documentation (updates to the documentation, readme or JSdoc annotations)
• 🐞 Bug fix (a non-breaking change that fixes an issue)
• 👌 Enhancement (improving an existing functionality like performance)
• ✨ New feature (a non-breaking change that adds functionality)
• 🧹 Chore (updates to the build process or auxiliary tools and libraries)
• ⚠️ Breaking change (fix or feature that would cause existing functionality to change)

📚 Description

The current behaviour for refreshing the users tokens does not provide many options for me as developer. As a developer I would like to be able to extend or customize this behaviour.

This PR:

• adds new types RefreshHandler and RefreshHandlerConfig
• adds the possibility to configure a custom RefreshHandler via refreshHandler? property to auth.session
• extracts the default refreshing behaviour to a separate file

📝 Checklist

• I have linked an issue or discussion.
• I have added tests (if possible).
• I have updated the documentation accordingly.

[zoey-kaiser]

Hi @blumewas 👋

Have you had a chance to look at the review yet? Otherwise are there any other open questions I can help you with?

[blumewas]

Hi @zoey-kaiser,
I will try to put it on my agenda for today/this evening. The review got completely lost in all other PRs from work. Sorry for that.

[blumewas]

Hey @zoey-kaiser,
I have implemented the requested changes made by @phoenix-ru. I have also merged the current main into my feature branch.

[zoey-kaiser]

I have implemented the requested changes made by @phoenix-ru. I have also merged the current main into my feature branch.

Hi @blumewas 👋

Thank you so much, sadly the lint is currently failing. However, its just an extra console statement and unneeded semi column. We can already begin on another review, but we will need to wait to merge until the linter passes 😊

[blumewas]

Sorry my bad 😅 I have now removed the console statement which made the linter fail

[phoenix-ru]

Thanks for the PR :)
I think it's good in its current state already.

I noticed that it's missing the website documentation, but I also checked SessionConfig here and it looks like this may also be a bit outdated (we have docs revamp planned anyway).

Would you be able to copy your options to the doc or should we do that ourselves?

[blumewas]

I can do that later today. If you want to merge it already then it would be better if you will do it 😄