feat!: replace OpenSubsonic with a native mood-first API
CI / chart (push) Successful in 3s
CI / chart-push (push) Successful in 3s
CI / test (push) Successful in 1m40s
CI / image (push) Successful in 3m12s

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:
TapTap committed 2026-11-14 17:54:44 +00:00
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 = '';
File diff suppressed because it is too large. Load diff