The per-episode negative ids (TrackItem::podcast_track_id below PODCAST_TRACK_ID_MAX) were a magic id range in shared code, which the podcast requirements forbid. Podcast items now use the fixed sentinel TrackItem::NOT_A_LIBRARY_ROW (-1) as id, release_id and artist id; it carries no identity. Their identity is TrackItem.podcast alone. Add TrackItem::key returning a typed TrackItemKey (library row, federated owner and item id, podcast episode id, or transient), with the stable string forms lib:<id>, fed:<owner>:<item_id>, ep:<episode id> and tmp:<id>, so clients key queue items by source instead of by numeric id. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
3.2 KiB
3.2 KiB
Changelog
Unreleased — podcast contract
music-dht 0.6.0(breaking): newmusic_dht::podcastmodule with the shared podcast contract: canonicalFeedUrl,PodcastId/EpisodeIdderivation (furumi-podcast:*:v1), feed aliases, the no-GUID episode identity rule,PodcastMeta/EpisodeMeta/PodcastEpisodeRef, and convergent merge rules for subscriptions, shares, progress registers and listening sessions.music-dht 0.6.0: optionalpodcast-feedfeature with the shared tolerant RSS/Atom parser (quick-xml,encoding_rs,url).music-dht 0.6.0: device-sync protocol version 4 (ALPN unchanged): fivepodcast_*operation kinds (subscription, share, feed aliases, progress, listening sessions), bounded podcast snapshot sections,PlaybackTrack.source, reservedPlaybackStateWire.playback_rate,DeviceProfileSet.protocol_version, optionalInviteWireprotocol version (p), self-reported vs relayed version helpers, version-gating helpers and Jam redaction. New struct fields and enum variants break exhaustive construction and matching in clients.furumi-library 0.3.0: followsmusic-dht 0.6.0, whose types it re-exposes.furumi-library 0.3.0: newfurumi_library::podcasts::PodcastStore, the SQLite reference store of the podcast contract in its ownpodcasts.sqlite3:user_versionmigrations that import the prototype podcast database (tables kept aslegacy_*, unimportable rows inlegacy_quarantine) and refuse newer or foreign files unchanged; podcasts, feed aliases, seasons, episodes, subscription/share/progress registers, listening sessions and local-only fetch state; local actions that return thepodcast_*operations for the client's sync log;apply_remote_op, bounded snapshot export and merge; RSS refresh ingestion with stable episode ids; UI queries. Enables themusic-dhtpodcast-feedfeature.furumi-library 0.3.0(breaking):TrackItem.podcast: Option<PodcastEpisodeRef>andTrackItem::podcast_episode/is_podcast. ExhaustiveTrackItemliterals in clients need the new field; music-only code must skip podcast items. Podcast items use the fixed sentinelTrackItem::NOT_A_LIBRARY_ROW(-1) asid,release_idand artist id, so existingid < 0/release_id < 0checks already treat them as non-library items; the sentinel carries no identity. NewTrackItem::key/TrackItemKey(lib:<id>,fed:<owner>:<item_id>,ep:<episode id>): clients must key queue items by it, not byid. The library database is unchanged.furumi-library 0.3.0: prototype import collapses rows of one GUID-less item under several enclosure URLs, and the first refresh re-keys imported GUID-less episodes without personal state to the ids the current feed gives, so they match devices that never had the prototype. Fetch-state writes are atomic across threads and processes.- See
PODCASTS.mdfor the normative contract.
v0.4.1 — 2026-09-02
federation-net 0.3.1: recover timed-out or failed Mainline-DHT rendezvous clients and expose network health to applications.music-dht 0.4.1: retain temporarily unreachable contacts and serialize duplicate dial attempts with bounded backoff.