feat: switch local cache to an interface

[wschurman]

Why

We've fallen too far behind on lru-cache. We previously decided to lock it @ 6.x in #170 because our use case couldn't pre-allocate all the data structures ahead of time efficiently.

But while reading the thread for that, I noticed the author has a ttl-cache: isaacs/node-lru-cache#208 (comment). This is much closer to our needs.

We essentially simulate a LRU cache by updating the TTL on each get: https://github.com/isaacs/ttlcache?tab=readme-ov-file#cachegetkey-updateageonget-checkageonget-ttl--

Because our TTL is short yet we require storing N caches this use case is more optimal.

Ref: ENG-18193

How

Switch to ttl-cache but only as a dev dependency, make exported API an interface so that consumers can choose between old lru-cache and ttl-cache.

Test Plan

Run all tests.

[wschurman]

• chore: upgrade to node 24 LTS #323
• feat: switch local cache to an interface #322 👈 (View in Graphite)
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[linear]

ENG-18193 Update lru-cache in entity and www

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (9140938) to head (3d3c5a4).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff            @@
##              main      #322   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files           87        87           
  Lines        12174     12187   +13     
  Branches       619       637   +18     
=========================================
+ Hits         12174     12187   +13     

Flag	Coverage Δ
integration	7.52% <0.00%> (-0.01%)	⬇️
unittest	96.96% <100.00%> (+<0.01%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

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

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.