"""Regression tests for service worker API cache exclusion under subpath mounts. The WebUI can be served at /hermes/. In that deployment API requests look like /hermes/api/sessions, not /api/sessions. The service worker must treat those as network-only; otherwise cache-first handling can serve a stale sidebar session list until the browser cache/service-worker cache is cleared. """ from pathlib import Path ROOT = Path(__file__).resolve().parents[1] SW_SRC = (ROOT / "static" / "sw.js").read_text(encoding="utf-8") def test_service_worker_excludes_subpath_mounted_api_routes_from_cache(): assert "url.pathname.includes('/api/')" in SW_SRC, ( "service worker must bypass cache for subpath-mounted API routes like " "/hermes/api/sessions, not only root-mounted /api/*" ) def test_service_worker_excludes_subpath_mounted_health_routes_from_cache(): assert "url.pathname.includes('/health')" in SW_SRC, ( "service worker must bypass cache for subpath-mounted health routes like " "/hermes/health, not only root-mounted /health" ) def test_service_worker_documents_api_routes_are_never_cached(): assert "API and streaming endpoints" in SW_SRC assert "always go to network" in SW_SRC def test_service_worker_does_not_intercept_its_own_script(): assert "url.pathname.endsWith('/sw.js')" in SW_SRC, ( "service worker must bypass /sw.js so a stale cached worker cannot block cache-version updates" ) def test_service_worker_uses_network_first_for_page_navigation(): """Page navigations must hit the server before cache so expired auth redirects work.""" navigate_idx = SW_SRC.find("event.request.mode === 'navigate'") assert navigate_idx != -1, "service worker must special-case page navigations" fetch_idx = SW_SRC.find("fetch(event.request)", navigate_idx) cache_idx = SW_SRC.find("caches.match", navigate_idx) assert fetch_idx != -1, "navigation branch must try the live server first" assert cache_idx != -1, "navigation branch may use cached shell only as offline fallback" assert fetch_idx < cache_idx, ( "navigation requests must be network-first, not cache-first, so auth redirects " "and freshly set login cookies are honored without a manual refresh" ) def test_service_worker_does_not_precache_page_shell_under_auth(): """Do not cache './' during install; it may be the authenticated app or login redirect.""" shell_block = SW_SRC[SW_SRC.find("const SHELL_ASSETS"):SW_SRC.find("];", SW_SRC.find("const SHELL_ASSETS"))] assert "'./'" not in shell_block and '"./"' not in shell_block, ( "pre-caching './' can serve a stale authenticated app shell while logged out; " "navigation should populate shell cache only after a successful non-redirect network load" ) def test_service_worker_never_caches_login_page_or_login_script(): assert "url.pathname.endsWith('/login')" in SW_SRC or "url.pathname.includes('/login')" in SW_SRC, ( "service worker must bypass the login page so stale auth UI cannot survive until cache clear" ) assert "url.pathname.endsWith('/static/login.js')" in SW_SRC, ( "service worker must bypass static/login.js so stale login handlers cannot block password submit" ) def test_service_worker_only_cache_puts_shell_assets_or_valid_navigation_shell(): assert "SHELL_ASSETS.includes(shellPath)" in SW_SRC, ( "non-navigation cache puts must be limited to the explicit app shell asset allowlist; " "a generic cache-first handler can trap stale login.js until users clear cache" )