Senko-san
e45e578f54
Search results now report whether a hit is already saved (in_library,
track_id, availability). New RemoteLibraryService backs POST
/tracks/remote (idempotent placeholder save) and POST
/tracks/{id}/materialize (on-demand fetch via a new materialize_track
arq task, reusing in-flight jobs).
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
88 lines
2.2 KiB
Python
88 lines
2.2 KiB
Python
"""Track request/response schemas."""
|
|
|
|
import datetime as dt
|
|
import uuid
|
|
|
|
from pydantic import BaseModel, Field
|
|
|
|
from app.api.schemas.download import DownloadJobOut
|
|
|
|
|
|
class TrackOut(BaseModel):
|
|
id: uuid.UUID
|
|
title: str
|
|
artist_id: uuid.UUID
|
|
artist_name: str
|
|
album_id: uuid.UUID | None
|
|
album_title: str | None
|
|
duration_seconds: int | None
|
|
file_format: str | None
|
|
file_size: int | None
|
|
genre: str | None
|
|
year: int | None
|
|
track_number: int | None
|
|
metadata_status: str
|
|
metadata_error: str | None
|
|
enriched_at: dt.datetime | None
|
|
availability: str
|
|
source: str
|
|
has_cover: bool
|
|
created_at: dt.datetime
|
|
|
|
|
|
class TrackUpdate(BaseModel):
|
|
title: str | None = None
|
|
genre: str | None = None
|
|
year: int | None = None
|
|
|
|
|
|
class MetadataMatch(BaseModel):
|
|
"""One AcoustID candidate for the metadata editor's match picker (§A7)."""
|
|
|
|
acoustid: str
|
|
score: float
|
|
recording_mbid: str | None
|
|
release_group_mbid: str | None
|
|
title: str | None
|
|
artist: str | None
|
|
album: str | None
|
|
year: int | None
|
|
|
|
|
|
class MetadataMatchesOut(BaseModel):
|
|
items: list[MetadataMatch]
|
|
|
|
|
|
class MetadataApply(BaseModel):
|
|
"""Manual edits / accepted match applied via ``PUT /tracks/{id}/metadata``.
|
|
|
|
Sets ``metadata_status = manual`` (never overwritten by auto-enrichment)."""
|
|
|
|
title: str | None = None
|
|
artist_name: str | None = None
|
|
album_title: str | None = None
|
|
year: int | None = None
|
|
genre: str | None = None
|
|
track_number: int | None = None
|
|
|
|
|
|
class RemoteTrackSave(BaseModel):
|
|
"""Save a remote browse hit (§A4 discover) as a library placeholder —
|
|
``availability="remote"``, no audio until first play (plan: Model C)."""
|
|
|
|
source: str
|
|
source_id: str = Field(min_length=1)
|
|
title: str
|
|
artist: str | None = None
|
|
|
|
|
|
class MaterializeResponse(BaseModel):
|
|
"""Result of requesting that a placeholder track's audio be fetched.
|
|
|
|
``job`` is ``None`` when the track is already ``local`` — nothing to wait
|
|
for, the caller can stream immediately. Otherwise it's the (new or
|
|
already in-flight) job; poll ``GET /downloads/{job.id}`` until ``done``."""
|
|
|
|
track: TrackOut
|
|
job: DownloadJobOut | None
|