Phase 3: PWA offline caching (frontend only)

Adds a real Workbox runtime-caching strategy on top of the Phase 1 app-shell
precache: StaleWhileRevalidate (cache-and-refresh) for the five read
endpoints (rooms/mine, open rooms, room messages, room members, invites/mine)
with a bounded/expiring cache per endpoint, while /api/auth/* and all
mutations stay network-only. An OfflineBanner (navigator.onLine-driven) and
a clearer Composer status line ("Connecting..." vs "You're offline") surface
what's actually happening; api/client.ts gains a NetworkError distinct from
ApiError so a genuine cache-miss-while-offline shows a quiet empty state
instead of a red error.

Manual offline testing (backend stopped, `vite preview` against the real
production service worker) surfaced a real gap the plan hadn't accounted
for: GET /api/auth/me is intentionally NetworkOnly, but that meant
ProtectedRoute could never confirm a session while offline and always
bounced to /login -- none of the newly-cached room/message data was ever
reachable. Fixed by caching a minimal, non-sensitive "last known user" in
localStorage (lib/lastUser.ts) and having AuthContext fall back to it for
any *unconfirmed* auth check (network failure, or a down backend answering
through a live reverse proxy with its own 502/503/504 -- both happen in
real deployments, not just literal airplane-mode). Only a server-confirmed
401 still clears it and signs the user out; every real action still
re-checks the actual session cookie server-side, so this can't grant
anything -- it only keeps cached UI reachable.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
2026-08-13 21:34:26 -06:00
co-authored by Claude Sonnet 5
parent e9fcb9fea2
commit aeb2f3f6a5
14 changed files with 333 additions and 53 deletions
+30 -23
View File
@@ -1,4 +1,5 @@
import { useRef, useState, type KeyboardEvent } from 'react'
import { useOnlineStatus } from '../hooks/useOnlineStatus'
import './Composer.css'
interface ComposerProps {
@@ -10,6 +11,7 @@ interface ComposerProps {
export function Composer({ roomName, disabled, onSend }: ComposerProps) {
const [value, setValue] = useState('')
const textareaRef = useRef<HTMLTextAreaElement>(null)
const online = useOnlineStatus()
function autoGrow() {
const el = textareaRef.current
@@ -35,29 +37,34 @@ export function Composer({ roomName, disabled, onSend }: ComposerProps) {
return (
<div className="composer">
<textarea
ref={textareaRef}
rows={1}
value={value}
disabled={disabled}
onChange={(e) => {
setValue(e.target.value)
autoGrow()
}}
onKeyDown={handleKeyDown}
placeholder={`Message #${roomName}`}
/>
<button
type="button"
className="composer-send"
onClick={handleSend}
disabled={disabled || !value.trim()}
aria-label="Send message"
>
<svg width="15" height="15" viewBox="0 0 20 20" aria-hidden="true">
<polygon points="2,2 18,10 2,18 6,10" fill="currentColor" />
</svg>
</button>
<div className="composer-box">
<textarea
ref={textareaRef}
rows={1}
value={value}
disabled={disabled}
onChange={(e) => {
setValue(e.target.value)
autoGrow()
}}
onKeyDown={handleKeyDown}
placeholder={disabled ? (online ? 'Connecting…' : "You're offline") : `Message #${roomName}`}
/>
<button
type="button"
className="composer-send"
onClick={handleSend}
disabled={disabled || !value.trim()}
aria-label="Send message"
>
<svg width="15" height="15" viewBox="0 0 20 20" aria-hidden="true">
<polygon points="2,2 18,10 2,18 6,10" fill="currentColor" />
</svg>
</button>
</div>
{disabled && (
<div className="composer-status">{online ? 'Connecting…' : "You're offline — messages can't be sent right now"}</div>
)}
</div>
)
}