diff --git a/CHANGELOG.md b/CHANGELOG.md index c02cfba..bcf55db 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,20 @@ # Changelog +## v0.13.0 — 2026-11-19 + +- Use the shared `music-dht` 0.6 device-sync types and announce device-sync + protocol 4. Podcast operations and snapshot sections from other devices are + kept and relayed; devices below protocol 4 never receive them. +- Keep podcast episodes and other non-library queue items through the web + player, with their explicit source. The player labels and skips them; the + typed queue is stored next to `queue_json` (migrations `m_0054`, `m_0055`). +- Refuse a playback transfer of a queue with podcast episodes to a device that + needs an update, and ignore its playback commands while the queue has them. +- Store the protocol version each device reports itself instead of this + server's version; invites carry the inviter's version. +- Jam guests see podcast episodes of the host as private items and cannot add + or remove them. + ## v0.10.6 — 2026-09-02 - Recover federation automatically after sleep, prolonged idle, or a degraded rendezvous transport. diff --git a/Cargo.lock b/Cargo.lock index c9caabf..b03ea28 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -1986,7 +1986,7 @@ checksum = "e6d5a32815ae3f33302d95fdcb2ce17862f8c65363dcfd29360480ba1001fc9c" [[package]] name = "furumusic" -version = "0.12.4" +version = "0.13.0" dependencies = [ "anyhow", "async-stream", diff --git a/Cargo.toml b/Cargo.toml index 47a7fb7..07fda64 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "furumusic" -version = "0.12.4" +version = "0.13.0" edition = "2024" description = "Reusable web-app boilerplate: auth, OIDC/SSO, admin panel, user management, i18n, PostgreSQL" diff --git a/docs/administration.md b/docs/administration.md index 0b13bc8..9bbdbe5 100644 --- a/docs/administration.md +++ b/docs/administration.md @@ -71,6 +71,14 @@ Trusted-device pairing is separate from public catalog discovery. It connects a user's own Furumi players so likes, playlists, playback state, and control can move between approved devices. +Queues synchronized from other Furumi players can contain podcast episodes. The +web player keeps them in the queue, in order and with their position, and shows +them as **Podcast · not playable in the web player yet**; local playback skips +them. A device that does not support podcasts yet (device-sync protocol below +4, for example an older terminal player) cannot receive such a queue: selecting +it as the playback device shows that it needs an update, and the episodes stay +in the queue. Jam guests see podcast episodes of the host only as private items. + ## Admin statistics The only admin interface is `/admin/v2`, also reachable from `/admin/`. diff --git a/docs/development.md b/docs/development.md index bad10bc..c4cdb7c 100644 --- a/docs/development.md +++ b/docs/development.md @@ -35,6 +35,39 @@ source code, templates or prompts reuse the dependency layer when its recipe and toolchain are unchanged. Both dependency and application builds use `--locked`. Update the pinned build tools in `Dockerfile`; changing them rebuilds the cache. +## Connected devices and podcast queue items + +Trusted-device sync uses the shared `music_dht::device_sync` types (no local +copies) and announces protocol version 4. The web player has no podcast +features yet, but it keeps every v4 element it receives: + +- podcast operations stay in the operation log and are relayed to v4 devices + only; their registers and the podcast snapshot sections are merged with the + shared `music_dht::podcast` rules into `furumusic__fed_podcast_relay` + (opaque contract JSON) and returned in this server's snapshots; +- queue items that are not library tracks become external browser items + (`source` plus the verbatim `wire_track`), so podcast episodes and Jam + placeholders survive peer → server → browser → server → peer unchanged; +- `furumusic__playback_state.queue_items_json` stores the typed queue next to + `queue_json`. `queue_json` (library ids) is still written for rollback; the + typed value is used only while its recorded ids match `queue_json`. + +Everything sent to a device is gated by the version that device reported itself +(`profile_protocol_version`; relayed profiles only raise it). See the podcast +contract (`PODCASTS.md`) and `PLAYBACK_PROTOCOL.md` in the Frid repository. + +```bash +cargo test devices:: queue_items podcast_relay queue_persistence +node --test tests/player_queue_sources.test.cjs +# Migrated disposable PostgreSQL (start the server against it once): +FURU_DEVICE_SYNC_TEST_DATABASE_URL=postgresql://... \ + cargo test postgres_podcast_relay_gating_and_peer_versions -- --ignored +``` + +`wire_compat_tests` compares the shared types with the private copies of +0.12.x byte for byte; `fixtures/v3_hello.golden.json` is the v3 shape. Rewrite +it only for a deliberate change, with `FURUMUSIC_BLESS_GOLDEN=1`. + ## Contributing Bug reports, design discussions, and patches are welcome. Before submitting a