Service worker now applies the strategies the roadmap asks for :
* Static assets : StaleWhileRevalidate (already in place)
* HLS segments : CacheFirst, max-age 7d, max 50 entries
* API GET : NetworkFirst, 3s timeout
Stayed on the hand-rolled fetch handlers rather than migrating to
Workbox — the existing implementation already covers push notifications
+ background sync + notificationclick, and Workbox would bring 200+ KB
of runtime + a build-step dependency for a feature set we already have.
Changes
- public/sw.js
* HLS_CACHE_MAX_ENTRIES (50) + HLS_CACHE_MAX_AGE_MS (7d) +
NETWORK_FIRST_TIMEOUT_MS (3s) tunable at the top of the file.
* cacheAudio : reads the cached response's date header to skip
stale entries (>7d), and prunes the cache FIFO after every put
so the entry count never exceeds 50. Network-down path still
serves stale entries (the offline-playback acceptance).
* networkFirst : races the network against a 3s timer ; if the
timer fires AND a cached entry exists, serve cached + let the
network keep updating in the background. Timeout without a
cached fallback lets the network race continue.
* isAudioRequest now matches .ts and .m4s segments too (HLS).
- scripts/stamp-sw-version.mjs (new) : postbuild step that replaces
the literal __BUILD_VERSION__ placeholder in dist/sw.js with
YYYYMMDDHHMM-<short-sha>. Pre-Day 16 the placeholder shipped
literally — same string across every deploy meant browser caches
were never invalidated. Wired into npm run build + build:ci.
- tests/e2e/31-sw-offline-cache.spec.ts : 2 tests gated behind
E2E_SW_TESTS=1 (SW only registers in prod builds — dev server
skips registration via import.meta.env.DEV check). When enabled :
(1) registration + activation, (2) cached resource served while
context.setOffline(true).
Acceptance (Day 16) : strategies match spec ; offline playback works
once the user has played the segment once before going offline. The
e2e self-skips on dev unless E2E_SW_TESTS=1 is set against vite preview.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
- Deleted apps/web/src/utils/optimisticStoreUpdates.ts (unused file)
- File was unused - no imports found in codebase
- Mutations already use React Query's onMutate pattern
- No TypeScript errors after deletion
- Actions 4.4.1.2 and 4.4.1.3 complete
