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>
Sprint 3 = production assets (logo, icons, hero, textures). Most deliverables
are physical artistic work (artist Renaud + Nikola scans). This commit lays
the CODE scaffold so assets drop in without friction when delivered.
New : apps/web/src/components/branding/
- Logo.tsx — single source of truth for Talas / Veza brand rendering.
Replaces ad-hoc inline wordmarks (Sidebar/Navbar/Footer/landing each had
their own VEZA <h2>). Variants: wordmark / symbol / lockup. Sizes xs..xl.
Colors auto/ink/cyan/inverse. Optional tagline. Horizontal/vertical orient.
- assets/SymbolPlaceholder.tsx — geometric ink stroke + arc + dot, monochrome,
currentColor inheritance, scalable. Mirrors charte §3.1 brief. Replaced by
artist's hand-drawn mark in P0.1 of BRIEF_ARTISTE.
- Logo.stories.tsx — full Storybook coverage: variants, sizes, colors,
orientation, Talas vs Veza, all-sizes ladder.
- index.ts — barrel exports.
New : apps/web/src/components/icons/sumi/
- Play.tsx — first calligraphic icon stub (programmatic approximation per
charte §6.3). 9 more to come (Pause, Search, Profile, Chat, Upload,
Settings, Home, Close, Volume).
- index.ts — barrel + commented TODO list per priority.
- Used via existing components/icons/SumiIcon.tsx wrapper which falls back to
Lucide when no Sumi version exists.
Brand alignment of platform metadata :
- public/favicon.svg — Mizu cyan placeholder (#0098B5) replacing default
vite.svg. Mirrors SymbolPlaceholder geometry.
- public/manifest.json — theme_color #1a1a1a -> #0098B5 (SUMI accent),
background_color #ffffff -> #0D0D0F (charte §4.4 rule 1: no pure white).
- index.html — theme-color meta + msapplication-TileColor aligned to SUMI.
Favicon link points to /favicon.svg.
New doc : apps/web/docs/BRANDING.md
- Architecture map of brand assets in apps/web.
- Logo component API + usage examples.
- Asset deliverables status table (P0/P1/P2 from brief artiste, all 🟡 placeholders).
- Naming convention for raw scans + processed SVGs.
- Step-by-step "how to integrate a delivered asset" for wordmark and Sumi icon.
- Brand color guard (ESLint rule pointer).
Build OK (vite 12.6s). Typecheck clean. No visual regression — Sidebar/Navbar
inline wordmarks intentionally NOT migrated yet (they use fontWeight 300 which
contradicts charte's Bold requirement; a per-screen migration call later).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Phase 1 of the OpenAPI typegen migration. Brings orval@8.8.1 into the
monorepo (workspace-hoisted) and wires a custom mutator so generated
calls route through the existing Axios instance — interceptors for
auth / CSRF / retry / offline-queue / logging keep firing unchanged.
200 .ts files generated from veza-backend-api/openapi.yaml (3441 LOC),
covering 13 tags (auth, track, user, playlist, marketplace, chat,
dashboard, webhook, validation, logging, audit, comment, users).
Changes:
- apps/web/orval.config.ts (NEW): generator config, output
src/services/generated/, tags-split mode, vezaMutator.
- apps/web/src/services/api/orval-mutator.ts (NEW): translates
orval's (url, RequestInit) convention into AxiosRequestConfig
then apiClient. Forwards AbortSignal for React Query cancellation.
- apps/web/scripts/generate-types.sh: runs BOTH generators during
the migration (legacy typescript-axios + orval). B9 drops step 1.
- apps/web/scripts/check-types-sync.sh: extended to check drift on
both output trees.
- apps/web/eslint.config.js: ignores src/services/generated/
(orval emits overloaded function declarations that trip no-redeclare).
- .gitignore: narrowed the bare `api` SELinux rule to `/api` plus
`/veza-backend-api/api`. The old rule silently ignored
apps/web/src/services/api/ new files including orval-mutator.ts.
- apps/web/package.json + package-lock.json: orval@^8.8.1 added
as devDependency, plus @commitlint/cli + @commitlint/config-conventional
(referenced by .husky/commit-msg but missing from deps).
Out of scope: no hand-written service changes. Pilot developer.ts
lands in B2, bulk migration in B3-B8, cleanup in B9.
npm run typecheck and npm run lint both green (0 errors).
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
