Vellum/internal
mithral b82090ed29 Phase 7: games — ROM scanning, platforms, cloud saves, EmulatorJS
The RomM replacement.

- registry: a games media type with ~35 ROM extensions across NES, SNES, GB/GBA,
  N64, NDS, Genesis/Master System/Game Gear, PC Engine, Neo Geo Pocket,
  WonderSwan, Atari, Coleco, Intellivision, and PlayStation.
- games: platform detection from the file extension, mapping each to an
  EmulatorJS core. Platforms with no browser core are recognised but marked
  not-playable so the UI offers a download instead of a broken player.
- migration 0005: game_saves keyed by (user, item, slot). Save states are user
  data, not media — two people playing the same ROM keep their own progress.
- save endpoints with a 16 MiB cap and a validated slot name; the upload is
  read through a LimitReader so an unbounded body is refused rather than
  buffered.
- igdb provider: Twitch client-credentials flow with the token cached for its
  ~2 month lifetime, Apicalypse query body, and cover URLs normalised from
  protocol-relative t_thumb to https t_cover_big.
- searchTitle: strips "(USA)", "[!]", "(Rev 1)" and similar release tags before
  searching. "Sonic the Hedgehog (USA)" matched nothing; "Sonic the Hedgehog"
  matches immediately. Stored titles keep the original.
- web: GamePlayer embeds EmulatorJS and adds Load/Save-to-server buttons.

Verified live against IGDB: Sonic matched (id 316900) with real cover art; a
4 KB save uploaded, listed, downloaded byte-identical, and deleted.
2026-10-09 21:54:49 -04:00
..
auth Phase 1: accounts, sessions, per-library grants 2026-10-09 16:31:24 -04:00
core Phase 7: games — ROM scanning, platforms, cloud saves, EmulatorJS 2026-10-09 21:54:49 -04:00
httpapi Web UI: Svelte app, embedded into the binary 2026-10-09 16:40:58 -04:00
httpx Phase 1: accounts, sessions, per-library grants 2026-10-09 16:31:24 -04:00
jobs Phase 5: job queue and metadata providers 2026-10-09 21:16:07 -04:00
library Phase 7: games — ROM scanning, platforms, cloud saves, EmulatorJS 2026-10-09 21:54:49 -04:00
media Redesign the user-facing experience: home, browse, item pages 2026-10-09 21:38:11 -04:00
metadata Phase 7: games — ROM scanning, platforms, cloud saves, EmulatorJS 2026-10-09 21:54:49 -04:00
modules Phase 7: games — ROM scanning, platforms, cloud saves, EmulatorJS 2026-10-09 21:54:49 -04:00
natsort Phase 6a: directory grouping, audiobooks and music playback 2026-10-09 21:20:47 -04:00
progress Phase 3: EPUB module, file streaming, per-user progress 2026-10-09 16:36:27 -04:00
search Phase 2b: FTS5 search 2026-10-09 21:10:44 -04:00
stream Phase 3: EPUB module, file streaming, per-user progress 2026-10-09 16:36:27 -04:00