sonda/migrations/postgres/0005_libraries.sql
tgiachi 46463846b3 feat(library): named media libraries managed through the API
- feat(storage): libraries table (name, path); audio_files points at a library
  by id instead of repeating the root path; migration 0005 for both drivers
  turns every existing root into a library and keeps file ids, tracks and the
  missing flag
- feat(library): Libraries service validates names and paths: absolute, an
  existing directory, never the filesystem root, never inside or around
  another library (checked on real paths, so symlinks cannot hide an overlap)
- feat(api): admin-only GET/POST /libraries, PATCH/DELETE /libraries/{id} and
  POST /libraries/{id}/scan; deleting a library drops its index entries and
  keeps tracks and listening history
- feat(library): the scanner and the scan manager work on libraries; scanning
  with no libraries answers 409 no_libraries
- feat(streaming): the library directory comes from the database instead of
  a configured list of roots
- breaking(config): library.roots is removed; an old config fails with a hint
  to use POST /api/v1/libraries
- test: CRUD and duplicates on both databases, path change keeps files,
  upgrade of a database written before libraries existed
2026-11-11 13:30:25 +01:00

27 lines
1.3 KiB
SQL

-- Named media libraries. audio_files points at a library by id instead of
-- repeating the root path in every row.
CREATE TABLE libraries (
id BIGINT GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
name TEXT NOT NULL,
path TEXT NOT NULL UNIQUE, -- absolute directory
created_at BIGINT NOT NULL -- unix seconds
);
-- Case-insensitive uniqueness (SQLite uses COLLATE NOCASE for the same effect).
CREATE UNIQUE INDEX libraries_name_lower ON libraries (lower(name));
-- Existing data: every distinct root becomes a library. The path doubles as
-- the name, which is always unique; admins can rename it afterwards.
INSERT INTO libraries (name, path, created_at)
SELECT DISTINCT root, root, extract(epoch FROM now())::bigint FROM audio_files;
ALTER TABLE audio_files ADD COLUMN library_id BIGINT REFERENCES libraries(id) ON DELETE CASCADE;
UPDATE audio_files f SET library_id = l.id FROM libraries l WHERE l.path = f.root;
ALTER TABLE audio_files ALTER COLUMN library_id SET NOT NULL;
-- Dropping the column also drops UNIQUE (root, rel_path).
ALTER TABLE audio_files DROP COLUMN root;
ALTER TABLE audio_files ADD CONSTRAINT audio_files_library_rel_path_key UNIQUE (library_id, rel_path);
CREATE INDEX idx_audio_files_library ON audio_files(library_id);