Convert received playback items without copying wire ids
Add TrackItem::from_playback_track and PlaybackItem: a received podcast episode becomes TrackItem::podcast_episode (sentinel ids) and a Jam private placeholder gets no TrackItem, so the wire ids (0 for both) are never copied. Narrow the TrackItem::key guidance: it is the source identity, episodes must never be keyed by id, and content-first music matching stays as it is. Document how TrackItem::podcast_episode differs from the wire form. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
b8d8b532f2
commit
d2530dca6c
6 files changed
+169
-40
No files matched your search
+7
-5
@@ -53,11 +53,13 @@ converges independently of delivery order. Migrations follow
|
||||
`PRAGMA user_version`; the prototype podcast database is imported and its
|
||||
tables are kept as `legacy_*`; newer or foreign files are refused unchanged.
|
||||
`TrackItem.podcast` marks episode queue items, which music-only code must
|
||||
skip. Queue items are keyed by `TrackItem::key` (a typed `TrackItemKey`:
|
||||
library row, federated owner and item id, or episode id), never by the
|
||||
numeric id: episodes use the fixed sentinel id, `release_id` and artist id
|
||||
-1, which carries no identity and only keeps code written for library
|
||||
tracks (`id >= 0`) away from them. See the "SQLite reference store" section
|
||||
skip. An episode queue item is identified by its episode id
|
||||
(`TrackItem::key`, a typed source identity: library row, federated owner and
|
||||
item id, or episode id), never by the numeric id: episodes use the fixed
|
||||
sentinel id, `release_id` and artist id -1, which carries no identity and
|
||||
only keeps code written for library tracks (`id >= 0`) away from them.
|
||||
Received playback items are converted with `TrackItem::from_playback_track`,
|
||||
which never copies the wire ids (0 for episodes and private placeholders). See the "SQLite reference store" section
|
||||
of [PODCASTS.md](PODCASTS.md).
|
||||
|
||||
Filesystem scanning schedules, playback, federation lifecycle, and UI state
|
||||
|
||||
Reference in new issue
Block a user