feat!: replace OpenSubsonic with a native mood-first API
Remove the /rest compatibility layer and the playlist model. Moods are now first-class private collections, and playback is driven by short-lived radio sessions whose queues are generated by the server. - Bearer device tokens (hashed) with revocable sessions. - Library snapshot/delta sync with tombstones and per-folder scoping. - Mood CRUD, seeds, preview and recommendations. - Radio batches weighted by seeds, genres, artists, text and playback affinity. - Playback events (started/completed/skipped) and explicit add-to-mood. - Stream, download and cover endpoints with query-token support for browsers. - V5 migration drops playlists and migrates existing moods; scanner writes tombstones and song update timestamps. - Built-in UI rebuilt on the native API with a radio player. - Native API integration tests and a rewritten smoke test (49 checks). - Chart bumped to 0.2.0. BREAKING CHANGE: the OpenSubsonic API and static playlists are gone.
This commit is contained in:
1 parent
28bfdd9d00
commit
b33eb076c1
46 files changed
+3472
-5823
No files matched your search
@@ -0,0 +1,164 @@
|
||||
-- Native mood-first API.
|
||||
--
|
||||
-- The OpenSubsonic layer is gone, so moods no longer need to be materialized as
|
||||
-- playlists. They become first-class rows, radio queues are generated per
|
||||
-- playback session, and the old playlist tables are dropped.
|
||||
|
||||
CREATE TABLE moods_v2 (
|
||||
id TEXT PRIMARY KEY,
|
||||
owner TEXT NOT NULL REFERENCES users(name) ON DELETE CASCADE,
|
||||
name TEXT NOT NULL,
|
||||
description TEXT,
|
||||
query TEXT,
|
||||
genres TEXT NOT NULL DEFAULT '[]',
|
||||
target_size INTEGER NOT NULL DEFAULT 30,
|
||||
refresh_hours INTEGER NOT NULL DEFAULT 24,
|
||||
yt_enabled BOOLEAN NOT NULL DEFAULT 1,
|
||||
last_discovery_at TEXT,
|
||||
created_at TEXT NOT NULL,
|
||||
changed_at TEXT NOT NULL,
|
||||
last_error TEXT
|
||||
);
|
||||
|
||||
INSERT INTO moods_v2 (
|
||||
id, owner, name, description, query, genres, target_size,
|
||||
refresh_hours, yt_enabled, created_at, changed_at, last_error
|
||||
)
|
||||
SELECT
|
||||
m.playlist_id,
|
||||
p.owner,
|
||||
p.name,
|
||||
p.comment,
|
||||
m.query,
|
||||
m.genres,
|
||||
m.target_size,
|
||||
m.refresh_hours,
|
||||
1,
|
||||
p.created_at,
|
||||
p.changed_at,
|
||||
m.last_error
|
||||
FROM moods m
|
||||
JOIN playlists p ON p.id = m.playlist_id;
|
||||
|
||||
CREATE TABLE mood_seeds_v2 (
|
||||
mood_id TEXT NOT NULL REFERENCES moods_v2(id) ON DELETE CASCADE,
|
||||
song_id TEXT NOT NULL REFERENCES songs(id) ON DELETE CASCADE,
|
||||
origin TEXT NOT NULL DEFAULT 'manual'
|
||||
CHECK (origin IN ('manual', 'recommendation', 'yt')),
|
||||
added_at TEXT NOT NULL,
|
||||
PRIMARY KEY (mood_id, song_id)
|
||||
);
|
||||
|
||||
-- Stars no longer exist. Songs liked under the old model become manual seeds.
|
||||
INSERT INTO mood_seeds_v2 (mood_id, song_id, origin, added_at)
|
||||
SELECT
|
||||
playlist_id,
|
||||
song_id,
|
||||
CASE origin WHEN 'manual' THEN 'manual' ELSE 'manual' END,
|
||||
added_at
|
||||
FROM mood_seeds;
|
||||
|
||||
CREATE TABLE mood_recommendations_v2 (
|
||||
mood_id TEXT NOT NULL REFERENCES moods_v2(id) ON DELETE CASCADE,
|
||||
video_id TEXT NOT NULL,
|
||||
title TEXT NOT NULL,
|
||||
artist TEXT NOT NULL,
|
||||
album TEXT,
|
||||
duration INTEGER,
|
||||
thumbnail TEXT,
|
||||
state TEXT NOT NULL DEFAULT 'new'
|
||||
CHECK (state IN ('new', 'accepted', 'rejected', 'unavailable')),
|
||||
matched_song_id TEXT REFERENCES songs(id) ON DELETE SET NULL,
|
||||
times_added INTEGER NOT NULL DEFAULT 0,
|
||||
first_seen TEXT NOT NULL,
|
||||
last_seen TEXT NOT NULL,
|
||||
PRIMARY KEY (mood_id, video_id)
|
||||
);
|
||||
|
||||
INSERT INTO mood_recommendations_v2 (
|
||||
mood_id, video_id, title, artist, duration, state,
|
||||
matched_song_id, times_added, first_seen, last_seen
|
||||
)
|
||||
SELECT
|
||||
playlist_id, video_id, title, artist, duration, state,
|
||||
matched_song_id, times_added, first_seen, last_seen
|
||||
FROM mood_recommendations;
|
||||
|
||||
DROP TABLE mood_recommendations;
|
||||
DROP TABLE mood_seeds;
|
||||
DROP TABLE moods;
|
||||
DROP TABLE playlist_songs;
|
||||
DROP TABLE playlists;
|
||||
|
||||
ALTER TABLE moods_v2 RENAME TO moods;
|
||||
ALTER TABLE mood_seeds_v2 RENAME TO mood_seeds;
|
||||
ALTER TABLE mood_recommendations_v2 RENAME TO mood_recommendations;
|
||||
|
||||
CREATE INDEX idx_moods_owner ON moods (owner);
|
||||
CREATE INDEX idx_mood_seeds_song ON mood_seeds (song_id);
|
||||
CREATE INDEX idx_mood_recommendations_song ON mood_recommendations (matched_song_id);
|
||||
|
||||
-- Device sessions. Only the SHA-256 hash of the bearer token is stored.
|
||||
CREATE TABLE api_tokens (
|
||||
id TEXT PRIMARY KEY,
|
||||
user_name TEXT NOT NULL REFERENCES users(name) ON DELETE CASCADE,
|
||||
token_hash TEXT NOT NULL UNIQUE,
|
||||
device_name TEXT NOT NULL,
|
||||
platform TEXT NOT NULL,
|
||||
created_at TEXT NOT NULL,
|
||||
last_used_at TEXT NOT NULL,
|
||||
expires_at TEXT NOT NULL
|
||||
);
|
||||
|
||||
CREATE INDEX idx_api_tokens_user ON api_tokens (user_name);
|
||||
|
||||
-- A playback session belongs to one mood. Queue items and events are kept so a
|
||||
-- client can resume and so radio ranking learns from skips and completions.
|
||||
CREATE TABLE playback_sessions (
|
||||
id TEXT PRIMARY KEY,
|
||||
user_name TEXT NOT NULL REFERENCES users(name) ON DELETE CASCADE,
|
||||
mood_id TEXT NOT NULL REFERENCES moods(id) ON DELETE CASCADE,
|
||||
next_position INTEGER NOT NULL DEFAULT 0,
|
||||
created_at TEXT NOT NULL,
|
||||
last_seen_at TEXT NOT NULL,
|
||||
closed_at TEXT
|
||||
);
|
||||
|
||||
CREATE INDEX idx_playback_sessions_user ON playback_sessions (user_name, last_seen_at);
|
||||
|
||||
CREATE TABLE playback_session_items (
|
||||
session_id TEXT NOT NULL REFERENCES playback_sessions(id) ON DELETE CASCADE,
|
||||
position INTEGER NOT NULL,
|
||||
song_id TEXT NOT NULL REFERENCES songs(id) ON DELETE CASCADE,
|
||||
state TEXT NOT NULL DEFAULT 'queued'
|
||||
CHECK (state IN ('queued', 'started', 'completed', 'skipped')),
|
||||
queued_at TEXT NOT NULL,
|
||||
updated_at TEXT NOT NULL,
|
||||
PRIMARY KEY (session_id, position)
|
||||
);
|
||||
|
||||
CREATE INDEX idx_session_items_song ON playback_session_items (song_id);
|
||||
|
||||
CREATE TABLE song_affinity (
|
||||
user_name TEXT NOT NULL REFERENCES users(name) ON DELETE CASCADE,
|
||||
song_id TEXT NOT NULL REFERENCES songs(id) ON DELETE CASCADE,
|
||||
completions INTEGER NOT NULL DEFAULT 0,
|
||||
skips INTEGER NOT NULL DEFAULT 0,
|
||||
last_event_at TEXT NOT NULL,
|
||||
PRIMARY KEY (user_name, song_id)
|
||||
);
|
||||
|
||||
-- Clients sync by revision. Deletions are explicit so offline libraries can drop
|
||||
-- removed files instead of keeping them forever.
|
||||
CREATE TABLE library_tombstones (
|
||||
entity TEXT NOT NULL,
|
||||
entity_id TEXT NOT NULL,
|
||||
deleted_at TEXT NOT NULL,
|
||||
PRIMARY KEY (entity, entity_id)
|
||||
);
|
||||
|
||||
CREATE INDEX idx_library_tombstones_deleted ON library_tombstones (deleted_at);
|
||||
|
||||
-- Scanner deltas need a changed timestamp independent of the file mtime.
|
||||
ALTER TABLE songs ADD COLUMN updated_at TEXT NOT NULL DEFAULT '';
|
||||
UPDATE songs SET updated_at = created_at WHERE updated_at = '';
|
||||
+526
-484
File diff suppressed because it is too large.
Load diff
Reference in new issue
Block a user