feat(cache): add duration option

[ryuapp]

closes #3340

WIP.

The author should do the following, if applicable

• Add tests
• Run tests
• bun run format:fix && bun run lint:fix to format the code
• Add TSDoc/JSDoc to document the code

[codecov]

Codecov Report

Attention: Patch coverage is 45.00000% with 22 lines in your changes missing coverage. Please review.

Project coverage is 95.55%. Comparing base (dfbd717) to head (6ee6ca8).

Files with missing lines	Patch %	Lines
src/middleware/cache/index.ts	35.29%	22 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #3367      +/-   ##
==========================================
- Coverage   95.77%   95.55%   -0.22%     
==========================================
  Files         155      155              
  Lines        9310     9345      +35     
  Branches     2725     2742      +17     
==========================================
+ Hits         8917     8930      +13     
- Misses        393      415      +22     

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

[yusukebe]

@ryuapp

I agree with adding an "expiration" feature to the Cache Middleware. This implementation seems good. If the PR is ready, please ping me!

[usualoma]

Thanks for the great pull request! I've commented on two of them, please check them out.

The part using Date.now(), I think we can test using vi.useFakeTimers(). If we want to be careful about testing, we may add runtime_tests, but in that case we are not sure if we can mock Date.now() cleanly or not.

[ryuapp]

This PR is almost complete apart from conflicts, but I have other ideas so it's on hold. The duration option works as a simple expiration time, but it is less flexible.
So I think it makes more sense to respect headers like Cache-Control the same way Cloudflare Workers does.
Options like respect.

app.use(cache({
    cacheName: 'my-app',
    cacheControl: 'max-age=60',
    respect: true, // Control cache by respecting headers like Cloudflare Workers
    wait: true,
}))

@usualoma
I'm sorry for putting it on hold for a while despite your review.
I will use your points in next PR. Thank you.