diff --git a/CHANGELOG.md b/CHANGELOG.md index 78e3f28..3f351db 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -52,7 +52,10 @@ and 8443: names are resolved and checked once per connection (no DNS rebinding), IP literals and every redirect hop are checked, and no cookies, credentials or system proxies are used. Users see only the kind of a - failure; details go to the logs without URLs. + failure; details go to the logs without URLs. A host name that resolves to + a blocked address gets the same answer as one that does not resolve. +- The browser can add at most 10 000 episodes outside the account's feeds + (handed-off queue items) through the playback endpoint (HTTP 422 beyond). ## v0.13.0 — 2026-11-19 diff --git a/docs/development.md b/docs/development.md index 8ace6b5..fba2ab1 100644 --- a/docs/development.md +++ b/docs/development.md @@ -137,8 +137,11 @@ The runtime around the store lives next to it in `src/podcasts/`: `/api/podcasts`. The proxy takes an episode id, loads the URL from the account's catalog (`PodcastStore::audio_source`), forwards a single sanitized byte `Range`, passes 200/206/416 through, accepts audio content - types only (a generic binary type is replaced by the stored enclosure type - or the URL extension), and stops at 1 GiB, 20 s without headers, 30 s + types only (a generic binary type needs an audio URL extension or a file + that starts like audio, `sniff_audio`: read from the response when it + starts at byte 0 and has at least 16 bytes, otherwise with its own + `bytes=0-15` request; the feed's enclosure type is never trusted), and + stops at 1 GiB, 20 s without headers, 30 s without data or 4 h per response. It is off unless `podcast_audio_proxy_enabled` is set; by default the browser streams from the publisher URL. @@ -177,7 +180,10 @@ at once on pause, stop or the end of the stream) records the old session and starts a new explicit one (`_takeOverEpisode`). A browser that loses the active role sends one final `stop` at its session generation (it records the listening; the new device's start keeps the register), unless it handed off -itself. Marking the loaded episode played or unplayed in the same tab saves +itself and the transfer went through (a failed transfer clears `handedOff` in +the devices store's `select`). Preparing the same episode again (Play after +its source failed) waits for the old session's final report, so the server +resumes from where the audio stopped. Marking the loaded episode played or unplayed in the same tab saves and closes its session and pauses it. Prev on an episode goes back 15 s locally instead of resetting it. Jam guests never play or save episodes (they only ever see placeholders). The `podcasts` store backs the Podcasts