feat(lru-cache): support options and fetchMethod

[patzick]

🔗 Linked issue

• no related issue

❓ 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

• replaced cache.get withcache.fetch. it is not a breaking change. The usage is the same

If fetch method is not provided, then cache.fetch(key) is equivalent to Promise.resolve(cache.get(key)).

source in docs

• that allows to provide fetchMethod for the driver and use stale-while-revalidate strategy to improve cache performence
• added docs entry to inform about that possibility

Sidenote

This PR will conflict with #320 as I wanted to create two separate PRs because the overall scope differs.
I'll update this or the other PR whenever the second one is merged.

📝 Checklist

• I have linked an issue or discussion.
• I have updated the documentation accordingly.

[nuxt-studio]

✅ Live Preview ready!

Name	Edit	Preview	Latest Commit
unstorage	Edit on Studio ↗︎	View Live Preview	85347dd

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 58.78%. Comparing base (4d61c78) to head (ca1decc).
Report is 80 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #321      +/-   ##
==========================================
- Coverage   65.05%   58.78%   -6.28%     
==========================================
  Files          39       39              
  Lines        4055     3142     -913     
  Branches      487      527      +40     
==========================================
- Hits         2638     1847     -791     
+ Misses       1408     1286     -122     
  Partials        9        9              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[patzick]

@pi0 thanks for merging #320, The conflict with this PR is resolved and it's ready to be merged too :)