feat(10-02): add sqlc queries for libraries and update playlist queries for phantom support

- Create libraries.sql with 7 CRUD queries (create, get, get-by-path, list, update, delete, count)
- Update playlists.sql: AddPlaylistTrack now accepts 9 params including phantom metadata
- Update playlist queries to use LEFT JOIN for nullable audio_file_id
- Add GetTrackPhantomMetadata helper query for eager phantom population
- Add is_phantom computed column to metadata queries
- Add GetAudioFilesByLibrary and CountAudioFilesByLibrary queries
- Regenerate all sqlc code

backend/database/sql/queries/playlists.sql

@@ -18,13 +18,20 @@ DELETE FROM playlists WHERE id = ?;
 SELECT COUNT(*) AS count FROM playlists WHERE name = ?;
 
 -- name: AddPlaylistTrack :one
-INSERT INTO playlist_tracks (playlist_id, audio_file_id, position) VALUES (?, ?, ?)
+INSERT INTO playlist_tracks (
+    playlist_id, audio_file_id, position,
+    phantom_title, phantom_artist, phantom_album,
+    phantom_duration_ms, phantom_genre, phantom_cover_art_path
+) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
 RETURNING *;
 
 -- name: GetPlaylistTracks :many
-SELECT pt.id, pt.playlist_id, pt.audio_file_id, pt.position, af.file_path
+SELECT pt.id, pt.playlist_id, pt.audio_file_id, pt.position,
+    COALESCE(af.file_path, '') AS file_path,
+    pt.phantom_title, pt.phantom_artist, pt.phantom_album,
+    pt.phantom_duration_ms, pt.phantom_genre, pt.phantom_cover_art_path
 FROM playlist_tracks pt
-JOIN audio_files af ON pt.audio_file_id = af.id
+LEFT JOIN audio_files af ON pt.audio_file_id = af.id
 WHERE pt.playlist_id = ?
 ORDER BY pt.position;
 
@@ -40,14 +47,15 @@ SELECT
     pt.playlist_id,
     pt.audio_file_id,
     pt.position,
-    af.file_path,
-    af.length_milliseconds,
-    COALESCE(r.name, '') AS title,
-    COALESCE(ac.text, '') AS artist,
-    COALESCE(rg.name, '') AS album,
-    COALESCE(ca.file_path, '') AS cover_art_path
+    COALESCE(af.file_path, '') AS file_path,
+    COALESCE(af.length_milliseconds, 0) AS length_milliseconds,
+    COALESCE(r.name, pt.phantom_title, '') AS title,
+    COALESCE(ac.text, pt.phantom_artist, '') AS artist,
+    COALESCE(rg.name, pt.phantom_album, '') AS album,
+    COALESCE(ca.file_path, pt.phantom_cover_art_path, '') AS cover_art_path,
+    CASE WHEN pt.audio_file_id IS NULL THEN 1 ELSE 0 END AS is_phantom
 FROM playlist_tracks pt
-JOIN audio_files af ON pt.audio_file_id = af.id
+LEFT JOIN audio_files af ON pt.audio_file_id = af.id
 LEFT JOIN recordings r ON af.recording_id = r.id
 LEFT JOIN artist_credit ac ON r.artist_credit_id = ac.id
 LEFT JOIN (
@@ -66,14 +74,15 @@ SELECT
     pt.playlist_id,
     pt.audio_file_id,
     pt.position,
-    af.file_path,
-    af.length_milliseconds,
-    COALESCE(r.name, '') AS title,
-    COALESCE(ac.text, '') AS artist,
-    COALESCE(rg.name, '') AS album,
-    COALESCE(ca.file_path, '') AS cover_art_path
+    COALESCE(af.file_path, '') AS file_path,
+    COALESCE(af.length_milliseconds, 0) AS length_milliseconds,
+    COALESCE(r.name, pt.phantom_title, '') AS title,
+    COALESCE(ac.text, pt.phantom_artist, '') AS artist,
+    COALESCE(rg.name, pt.phantom_album, '') AS album,
+    COALESCE(ca.file_path, pt.phantom_cover_art_path, '') AS cover_art_path,
+    CASE WHEN pt.audio_file_id IS NULL THEN 1 ELSE 0 END AS is_phantom
 FROM playlist_tracks pt
-JOIN audio_files af ON pt.audio_file_id = af.id
+LEFT JOIN audio_files af ON pt.audio_file_id = af.id
 LEFT JOIN recordings r ON af.recording_id = r.id
 LEFT JOIN artist_credit ac ON r.artist_credit_id = ac.id
 LEFT JOIN (
@@ -93,16 +102,16 @@ SELECT COALESCE(MAX(position), -1) + 1 AS next_position
 FROM playlist_tracks WHERE playlist_id = ?;
 
 -- name: GetPlaylistTrackFilePaths :many
-SELECT af.file_path
+SELECT COALESCE(af.file_path, '') AS file_path
 FROM playlist_tracks pt
-JOIN audio_files af ON pt.audio_file_id = af.id
-WHERE pt.playlist_id = ?
+LEFT JOIN audio_files af ON pt.audio_file_id = af.id
+WHERE pt.playlist_id = ? AND pt.audio_file_id IS NOT NULL
 ORDER BY pt.position;
 
 -- name: IsTrackInPlaylist :one
 SELECT EXISTS(
     SELECT 1 FROM playlist_tracks pt
-    JOIN audio_files af ON pt.audio_file_id = af.id
+    LEFT JOIN audio_files af ON pt.audio_file_id = af.id
     WHERE pt.playlist_id = ? AND af.file_path = ?
 ) AS in_playlist;
 
@@ -111,3 +120,29 @@ DELETE FROM playlist_tracks
 WHERE playlist_id = ? AND audio_file_id = (
     SELECT id FROM audio_files WHERE file_path = ?
 );
+
+-- name: GetTrackPhantomMetadata :one
+SELECT
+    COALESCE(r.name, '') AS title,
+    COALESCE(ac.text, '') AS artist,
+    COALESCE(rg.name, '') AS album,
+    af.length_milliseconds AS duration_ms,
+    CAST(COALESCE(
+        (SELECT GROUP_CONCAT(g.name, '||')
+         FROM recording_genres rg_sub
+         JOIN genres g ON rg_sub.genre_id = g.id
+         WHERE rg_sub.recording_id = r.id),
+        ''
+    ) AS TEXT) AS genre,
+    COALESCE(ca.file_path, '') AS cover_art_path
+FROM audio_files af
+LEFT JOIN recordings r ON af.recording_id = r.id
+LEFT JOIN artist_credit ac ON r.artist_credit_id = ac.id
+LEFT JOIN (
+    SELECT recording_id, MIN(release_group_id) AS release_group_id
+    FROM release_group_recordings
+    GROUP BY recording_id
+) rgr ON r.id = rgr.recording_id
+LEFT JOIN release_groups rg ON rgr.release_group_id = rg.id
+LEFT JOIN cover_art ca ON rg.cover_art_id = ca.id
+WHERE af.id = ?;