chore(deps): bump cached from 2.0.2 to 3.1.1

[dependabot]

Bumps cached from 2.0.2 to 3.1.1.

Release notes

Sourced from cached's releases.

cached_proc_macro-v3.0.1

What's Changed

• Pin the cargo-readme version CI installs by @​jaemk in jaemk/cached#321
• Correct the extreme-ttl doc claims about the sharded stores by @​jaemk in jaemk/cached#322
• Add ClaimRegistry: a single-flight guard for background refreshes by @​jaemk in jaemk/cached#323
• Capability traits, and borrowed keys on the sharded lookups by @​jaemk in jaemk/cached#324
• keep the generated clone inside the macro expansion so nightly clippy's clone_on_copy stays quiet by @​raimannma in jaemk/cached#325
• guard the generated clone's syntax context on nightly by @​jaemk in jaemk/cached#326
• release 4.0.0 / cached_proc_macro 3.0.1 by @​jaemk in jaemk/cached#327

Full Changelog: jaemk/cached@v3.1.1...cached_proc_macro-v3.0.1

cached_proc_macro-v3.0.0

What's Changed

• feat: remove CacheSetError, rename TtlSortedCache insert* to set*, wrap order-method values in CacheValue by @​jaemk in jaemk/cached#293
• feat: sharded peek, builder new(), ext alias parity, concurrent cache_try_get_or_set_with, retain on map stores by @​jaemk in jaemk/cached#294
• docs: fix cache_contains implementor listing and docsrs gate, note Arc<T> return pattern, add peek recency test by @​jaemk in jaemk/cached#295
• fix: clear Clone error for #[cached] return types, async_core docsrs badges, doc and spec corrections by @​jaemk in jaemk/cached#296
• feat: TtlSortedCache::set_with builder, ConcurrentCachePeek, ConcurrentCachedExt::try_get_or_set_with by @​jaemk in jaemk/cached#297
• feat: retain on TtlSortedCache and the six sharded stores by @​jaemk in jaemk/cached#298
• perf: in-memory and sharded store speedups; promote on cache_set overwrite by @​jaemk in jaemk/cached#299
• feat: derive default shard count from max_size, make cache_contains dyn-callable by @​jaemk in jaemk/cached#300
• feat: count evictions before on_evict, clear Clone error for #[once], no-callback retain fast path by @​jaemk in jaemk/cached#301
• 3.0.0-rc.10: retain returns removed count, ConcurrentCachePeekAsync, MSRV 1.92 by @​jaemk in jaemk/cached#302
• ci: trigger the release on an unpublished version, fail on partial publish by @​jaemk in jaemk/cached#303
• docs: correct the backfill claim in tag-release.sh by @​jaemk in jaemk/cached#304
• Collapse sharded *Base types, split refresh-on-hit traits, fix redis key collisions by @​jaemk in jaemk/cached#305
• Hasher in builder slot 3, drop the serde feature, fix stale docs by @​jaemk in jaemk/cached#306
• Panic-safe sweeps, result_fallback lost update, redis/redb correctness by @​jaemk in jaemk/cached#307
• Sharded overwrite on_evict key, migration guide corrections, proc_macro alias by @​jaemk in jaemk/cached#308
• Release 3.0.0 by @​jaemk in jaemk/cached#309

Full Changelog: jaemk/cached@v3.0.0-rc.9...cached_proc_macro-v3.0.0

cached_proc_macro_types-v3.0.0

What's Changed

• feat: remove CacheSetError, rename TtlSortedCache insert* to set*, wrap order-method values in CacheValue by @​jaemk in jaemk/cached#293
• feat: sharded peek, builder new(), ext alias parity, concurrent cache_try_get_or_set_with, retain on map stores by @​jaemk in jaemk/cached#294
• docs: fix cache_contains implementor listing and docsrs gate, note Arc<T> return pattern, add peek recency test by @​jaemk in jaemk/cached#295
• fix: clear Clone error for #[cached] return types, async_core docsrs badges, doc and spec corrections by @​jaemk in jaemk/cached#296
• feat: TtlSortedCache::set_with builder, ConcurrentCachePeek, ConcurrentCachedExt::try_get_or_set_with by @​jaemk in jaemk/cached#297
• feat: retain on TtlSortedCache and the six sharded stores by @​jaemk in jaemk/cached#298
• perf: in-memory and sharded store speedups; promote on cache_set overwrite by @​jaemk in jaemk/cached#299
• feat: derive default shard count from max_size, make cache_contains dyn-callable by @​jaemk in jaemk/cached#300
• feat: count evictions before on_evict, clear Clone error for #[once], no-callback retain fast path by @​jaemk in jaemk/cached#301
• 3.0.0-rc.10: retain returns removed count, ConcurrentCachePeekAsync, MSRV 1.92 by @​jaemk in jaemk/cached#302
• ci: trigger the release on an unpublished version, fail on partial publish by @​jaemk in jaemk/cached#303
• docs: correct the backfill claim in tag-release.sh by @​jaemk in jaemk/cached#304

... (truncated)

Changelog

Sourced from cached's changelog.

[3.1.1] - 2026-08-25

Documentation and tests only. There is no API or behavior change.

Documentation

• Document that a custom ty on #[concurrent_cached] requires the cached function to return Result<T, E>, with a compiling example on the ConcurrentCached trait. The macro cannot see the store's Error type at expansion time, so it always emits the fallible path. Previously this was only discoverable by hitting the compile error, which is now also pinned by a tests/ui case.
• New example examples/moka_custom_store.rs: adapting a third-party cache (moka) to ConcurrentCached. The orphan rule makes a local newtype mandatory for any foreign store, and the example records what an API that does not line up method-for-method costs to adapt, including returning the replaced value from cache_set without a get-then-set race. moka is a dev-dependency for the example only; it is not a dependency of the crate (#220).

[3.1.0] - 2026-08-24

Added

• CacheExpiry and ConcurrentCacheExpiry traits, providing cache_peek_expires_at() / peek_expires_at(): a side-effect-free per-key read returning (Option<V>, Option<Instant>) instead of the bool cache_peek_with_expiry_status returns, so callers can implement a threshold-based refresh (refresh when the remaining TTL drops below N) directly against the deadline (#91). Additive and non-breaking: standalone traits, not new required methods on CloneCached / ConcurrentCloneCached. Implemented by TtlCache, LruTtlCache, TtlSortedCache, ExpiringCache, ExpiringLruCache, ShardedTtlCache, ShardedLruTtlCache, ShardedExpiringCache, and ShardedExpiringLruCache. Both traits also provide a value-free cache_expires_at() / expires_at(), returning (bool, Option<Instant>) (presence, deadline) instead of cloning the value, for callers who only need the remaining time; it needs no V: Clone bound, since that bound moved off the impl blocks and onto the value-returning methods (cache_peek_expires_at / peek_expires_at). On ExpiringCache, ExpiringLruCache, ShardedExpiringCache, and ShardedExpiringLruCache the deadline comes from Expires::expires_at(), whose default body returns None: for an Expires impl that only implements is_expired (the crate's own documented recipe), the read reports None for both live and expired entries, and a threshold-refresh policy built on it silently never fires.

Documentation

• New runnable example examples/refresh_before_expiry.rs: recompute an entry once its remaining ttl drops below a threshold, using cache_peek_expires_at (peek_expires_at) to read the deadline and {fn}_prime_cache to refresh outside the cache write lock, so the stored value is replaced while still live and no caller reads an expired entry. Companion to examples/stale_while_revalidate.rs, which handles the already-expired case. Covers the sync #[cached], async #[cached], and async #[concurrent_cached] static shapes. No API change.

• New runnable example examples/stale_while_revalidate.rs: serve an expired value

... (truncated)

Commits

• 9e043bc release 3.1.1 (#320)
• 7b29095 record the #220 outcome in design 0054 (#319)
• 775b51c pin the Arc\<T> return pattern, correct the scope of design 0009 (#318)
• 8478d90 add a moka custom-store example, document the Result requirement (#317)
• f6ec397 document that the release pipeline tags and publishes (#316)
• dbc5698 release 3.1.0 (#315)
• f9d3483 add design records 0048 to 0054 (#314)
• d832c0a Add a per-key expiry read: CacheExpiry and ConcurrentCacheExpiry (#312)
• b4c8d8c release the stale-while-revalidate refresh claim from Drop (#313)
• 89a1024 Add single-flight revalidation to the stale-while-revalidate example (#311)
• Additional commits viewable in compare view

Dependabot will resolve any conflicts with this PR as long as you don't alter it yourself. You can also trigger a rebase manually by commenting @dependabot rebase.

---

Dependabot commands and options

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot show <dependency name> ignore conditions will show all of the ignore conditions of the specified dependency
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)