162e0cc449
* feat(audiobooks): redesign audiobook library around resume and series progression Audiobook libraries previously reused the video-shaped library page: a backdrop carousel hero (audiobooks have square covers and no backdrops), movie-style default sections, and a browse grid whose primary audiobook axes (author, narrator, series) were buried as filters. Backend: - New next_in_series section type: surfaces the next unstarted book, by series_index, in series the profile has finished a book of, ordered by most recent finish. Registered as a library-staple recipe. - New GET /api/v1/catalog/audiobook-groups endpoint: grouped browse by author/narrator/series with book count, total duration, per-profile progress counts, and poster URLs for cover stacks. - Audiobook library defaults: continue-listening is featured (renders as the Now Listening hero) with next-in-series directly after it. A data migration upgrades existing audiobook libraries, skipping layouts where an admin already featured a section. Frontend: - NowListeningHero replaces HeroBanner for audiobook libraries: resume deck with chapter position, hours left, ambient color from the cover, and one-click resume; remaining in-progress books render as the Continue Listening row. - Library tab gains Books/Series/Authors/Narrators browse axes persisted via the type param; selecting a group drops into the Books grid with the matching filter applied. - "Recommended" tab is labeled "Home" for audiobook libraries; audiobook continue cards use square covers and hr/min time-left formatting. - Shared audiobook chapter/file/duration helpers extracted to web/src/lib/audiobooks (deduplicated from AudiobookContent). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * fix(audiobooks): address review feedback on library redesign - Push library scoping into the next-in-series candidate SQL so finished series whose next book lives in another library can't consume the candidate limit and starve a library-scoped section (Codex P2). - Paginate the audiobook groups fetch until the server-reported total is reached (500/page, 20-page bound) so client-side filtering sees the complete author/narrator/series list (Codex P2, CodeRabbit). - Make the redesign migration rollback-safe: rows the Up touches carry config markers (featured_by_migration / seeded_by_migration) and the Down reverts only marked rows, leaving admin-set featured state and hand-created next_in_series sections alone (Codex P2, CodeRabbit). - Gate NowListeningHero's detail-derived files/credits on the detail matching the deck item, so Resume can't start the new book with the previous book's files while keepPreviousData shows stale detail (Codex P2). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> --------- Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
218 lines
11 KiB
Go
218 lines
11 KiB
Go
package sections
|
|
|
|
import (
|
|
"encoding/json"
|
|
"fmt"
|
|
|
|
"github.com/Silo-Server/silo-server/internal/catalog"
|
|
"github.com/Silo-Server/silo-server/internal/models"
|
|
)
|
|
|
|
// DefaultHomeSections returns the canonical default sections for the home scope.
|
|
// These are used for seeding fresh installs and the admin "Restore Defaults" action.
|
|
func DefaultHomeSections(libraries []*models.MediaFolder) []*PageSection {
|
|
result := []*PageSection{
|
|
{ID: "default-continue-watching", Scope: "home", Position: 0, SectionType: SectionContinueWatching, Title: "Continue Watching", ItemLimit: 20, Config: ContinueTypeConfig(ContinueTypeWatching), Enabled: true},
|
|
}
|
|
if hasAudiobookLibrary(libraries) {
|
|
result = append(result, &PageSection{
|
|
ID: "default-continue-listening",
|
|
Scope: "home",
|
|
Position: 1,
|
|
SectionType: SectionContinueWatching,
|
|
Title: "Continue Listening",
|
|
ItemLimit: 20,
|
|
Config: ContinueTypeConfig(ContinueTypeListening),
|
|
Enabled: true,
|
|
})
|
|
}
|
|
|
|
position := len(result)
|
|
for _, library := range libraries {
|
|
if library == nil {
|
|
continue
|
|
}
|
|
for _, section := range generatedHomeLibraryRecentDefaults(library.ID, library.Name, library.Type) {
|
|
section.Position = position
|
|
result = append(result, &PageSection{
|
|
ID: generatedHomeLibraryRecentID(section, library.ID),
|
|
Scope: section.Scope,
|
|
Position: section.Position,
|
|
SectionType: section.SectionType,
|
|
Title: section.Title,
|
|
ItemLimit: section.ItemLimit,
|
|
Config: section.Config,
|
|
Enabled: section.Enabled,
|
|
})
|
|
position++
|
|
}
|
|
}
|
|
|
|
result = append(result,
|
|
&PageSection{ID: "default-hidden-gems", Scope: "home", Position: position, SectionType: SectionHiddenGems, Title: "Hidden Gems", ItemLimit: 15, Config: json.RawMessage(`{"min_rating":7.5}`), Enabled: true},
|
|
)
|
|
position++
|
|
result = append(result,
|
|
&PageSection{ID: "default-trending", Scope: "home", Position: position, SectionType: SectionTrendingOnServer, Title: "Trending on Server", ItemLimit: 15, Config: json.RawMessage(`{"window":"7d"}`), Enabled: true},
|
|
)
|
|
position++
|
|
result = append(result,
|
|
&PageSection{
|
|
ID: "default-seasonal",
|
|
Scope: "home",
|
|
Position: position,
|
|
SectionType: SectionSeasonalThemed,
|
|
Title: "Seasonal Picks",
|
|
ItemLimit: 15,
|
|
Config: json.RawMessage(
|
|
`{"enabled_themes":["halloween","christmas","valentines","st_patricks","thanksgiving","summer_blockbuster","saturday_morning"]}`,
|
|
),
|
|
Enabled: true,
|
|
},
|
|
)
|
|
|
|
return result
|
|
}
|
|
|
|
func hasAudiobookLibrary(libraries []*models.MediaFolder) bool {
|
|
for _, library := range libraries {
|
|
if library != nil && IsAudiobookLibraryType(library.Type) {
|
|
return true
|
|
}
|
|
}
|
|
return false
|
|
}
|
|
|
|
func generatedHomeLibraryRecentID(section *PageSection, libraryID int) string {
|
|
kind := generatedHomeLibraryRecentKindForSection(section)
|
|
if kind == generatedHomeLibraryRecentKindReleasedEpisodes {
|
|
return fmt.Sprintf("default-home-%s-library-%d", kind, libraryID)
|
|
}
|
|
return fmt.Sprintf("default-home-%s-library-%d", section.SectionType, libraryID)
|
|
}
|
|
|
|
func generatedHomeLibraryRecentDefaults(libraryID int, libraryName, libraryType string) []*PageSection {
|
|
sections := []*PageSection{
|
|
{
|
|
Scope: "home",
|
|
SectionType: SectionRecentlyAdded,
|
|
Title: GeneratedHomeLibraryRecentTitle(SectionRecentlyAdded, libraryName),
|
|
ItemLimit: 20,
|
|
Config: GeneratedHomeLibraryRecentConfig(libraryID),
|
|
Enabled: true,
|
|
},
|
|
}
|
|
|
|
switch libraryType {
|
|
case "series":
|
|
sections = append(sections, &PageSection{
|
|
Scope: "home",
|
|
SectionType: SectionCustomFilter,
|
|
Title: fmt.Sprintf("Recently Released Episodes in %s", libraryName),
|
|
ItemLimit: 20,
|
|
Config: GeneratedHomeLibraryRecentEpisodesConfig(libraryID),
|
|
Enabled: true,
|
|
})
|
|
default:
|
|
sections = append(sections, &PageSection{
|
|
Scope: "home",
|
|
SectionType: SectionRecentlyReleased,
|
|
Title: GeneratedHomeLibraryRecentTitle(SectionRecentlyReleased, libraryName),
|
|
ItemLimit: 20,
|
|
Config: GeneratedHomeLibraryRecentConfig(libraryID),
|
|
Enabled: true,
|
|
})
|
|
}
|
|
|
|
return sections
|
|
}
|
|
|
|
func defaultQueryConfig(def catalog.QueryDefinition) json.RawMessage {
|
|
config, err := json.Marshal(def.Normalize())
|
|
if err != nil {
|
|
return json.RawMessage(`{}`)
|
|
}
|
|
return config
|
|
}
|
|
|
|
func defaultMediaScopeConfig(mediaScope string) json.RawMessage {
|
|
return defaultQueryConfig(catalog.QueryDefinition{
|
|
MediaScope: mediaScope,
|
|
Match: "all",
|
|
Groups: []catalog.QueryGroup{},
|
|
Sort: catalog.QuerySort{Field: "added_at", Order: "desc"},
|
|
})
|
|
}
|
|
|
|
func defaultTopRatedConfig(mediaScope string) json.RawMessage {
|
|
return defaultQueryConfig(catalog.QueryDefinition{
|
|
MediaScope: mediaScope,
|
|
Match: "all",
|
|
Groups: []catalog.QueryGroup{},
|
|
Sort: catalog.QuerySort{Field: "rating_imdb", Order: "desc"},
|
|
})
|
|
}
|
|
|
|
func defaultRecentEpisodesConfig() json.RawMessage {
|
|
return defaultQueryConfig(catalog.QueryDefinition{
|
|
MediaScope: "episode",
|
|
Match: "all",
|
|
Groups: []catalog.QueryGroup{},
|
|
Sort: catalog.QuerySort{Field: "release_date", Order: "desc"},
|
|
})
|
|
}
|
|
|
|
// DefaultLibrarySectionsForType returns the canonical default sections for a
|
|
// library type. These are used when seeding new libraries and restoring
|
|
// library defaults.
|
|
func DefaultLibrarySectionsForType(libraryID *int, libraryType string) []*PageSection {
|
|
emptyCfg := json.RawMessage(`{}`)
|
|
continueWatchingCfg := ContinueTypeConfig(ContinueTypeWatching)
|
|
|
|
switch libraryType {
|
|
case "movies", "movie":
|
|
return []*PageSection{
|
|
{ID: "default-continue-watching", Scope: "library", LibraryID: libraryID, Position: 0, SectionType: SectionContinueWatching, Title: "Continue Watching", ItemLimit: 20, Config: continueWatchingCfg, Enabled: true},
|
|
{ID: "default-recently-added-movies", Scope: "library", LibraryID: libraryID, Position: 1, SectionType: SectionRecentlyAdded, Title: "Recently Added Movies", ItemLimit: 20, Config: defaultMediaScopeConfig("movie"), Enabled: true},
|
|
{ID: "default-recently-released-movies", Scope: "library", LibraryID: libraryID, Position: 2, SectionType: SectionRecentlyReleased, Title: "Recently Released Movies", ItemLimit: 20, Config: defaultMediaScopeConfig("movie"), Enabled: true},
|
|
{ID: "default-top-rated-movies", Scope: "library", LibraryID: libraryID, Position: 3, SectionType: SectionCustomFilter, Title: "Top Rated Movies", ItemLimit: 20, Config: defaultTopRatedConfig("movie"), Enabled: true},
|
|
{ID: "default-recommended-for-you", Scope: "library", LibraryID: libraryID, Position: 4, SectionType: SectionRecommendedForYou, Title: "Recommended for You", ItemLimit: 20, Config: emptyCfg, Enabled: true},
|
|
{ID: "default-random-movies", Scope: "library", LibraryID: libraryID, Position: 5, SectionType: SectionRandom, Title: "Random Picks", ItemLimit: 20, Config: defaultMediaScopeConfig("movie"), Enabled: true},
|
|
}
|
|
case "series":
|
|
return []*PageSection{
|
|
{ID: "default-continue-watching", Scope: "library", LibraryID: libraryID, Position: 0, SectionType: SectionContinueWatching, Title: "Continue Watching", ItemLimit: 20, Config: continueWatchingCfg, Enabled: true},
|
|
{ID: "default-recently-added-tv", Scope: "library", LibraryID: libraryID, Position: 1, SectionType: SectionRecentlyAdded, Title: "Recently Added TV", ItemLimit: 20, Config: defaultMediaScopeConfig("series"), Enabled: true},
|
|
{ID: "default-recently-released-episodes", Scope: "library", LibraryID: libraryID, Position: 2, SectionType: SectionCustomFilter, Title: "Recently Released Episodes", ItemLimit: 20, Config: defaultRecentEpisodesConfig(), Enabled: true},
|
|
{ID: "default-top-rated-tv", Scope: "library", LibraryID: libraryID, Position: 3, SectionType: SectionCustomFilter, Title: "Top Rated TV", ItemLimit: 20, Config: defaultTopRatedConfig("series"), Enabled: true},
|
|
{ID: "default-recommended-for-you", Scope: "library", LibraryID: libraryID, Position: 4, SectionType: SectionRecommendedForYou, Title: "Recommended for You", ItemLimit: 20, Config: emptyCfg, Enabled: true},
|
|
{ID: "default-random-tv", Scope: "library", LibraryID: libraryID, Position: 5, SectionType: SectionRandom, Title: "Random Picks", ItemLimit: 20, Config: defaultMediaScopeConfig("series"), Enabled: true},
|
|
}
|
|
case "audiobooks", "audiobook":
|
|
// Continue Listening is featured: the library Home tab renders it as
|
|
// the "Now Listening" resume hero instead of a backdrop carousel.
|
|
return []*PageSection{
|
|
{ID: "default-continue-listening", Scope: "library", LibraryID: libraryID, Position: 0, SectionType: SectionContinueWatching, Title: "Continue Listening", Featured: true, ItemLimit: 20, Config: ContinueTypeConfig(ContinueTypeListening), Enabled: true},
|
|
{ID: "default-next-in-series", Scope: "library", LibraryID: libraryID, Position: 1, SectionType: SectionNextInSeries, Title: "Next in Your Series", ItemLimit: 20, Config: emptyCfg, Enabled: true},
|
|
{ID: "default-recently-added-audiobooks", Scope: "library", LibraryID: libraryID, Position: 2, SectionType: SectionRecentlyAdded, Title: "Recently Added Audiobooks", ItemLimit: 20, Config: defaultMediaScopeConfig("audiobook"), Enabled: true},
|
|
{ID: "default-recently-released-audiobooks", Scope: "library", LibraryID: libraryID, Position: 3, SectionType: SectionRecentlyReleased, Title: "Recently Released Audiobooks", ItemLimit: 20, Config: defaultMediaScopeConfig("audiobook"), Enabled: true},
|
|
{ID: "default-recommended-for-you", Scope: "library", LibraryID: libraryID, Position: 4, SectionType: SectionRecommendedForYou, Title: "Recommended for You", ItemLimit: 20, Config: emptyCfg, Enabled: true},
|
|
{ID: "default-random-audiobooks", Scope: "library", LibraryID: libraryID, Position: 5, SectionType: SectionRandom, Title: "Random Picks", ItemLimit: 20, Config: defaultMediaScopeConfig("audiobook"), Enabled: true},
|
|
}
|
|
default:
|
|
return DefaultLibrarySections(libraryID)
|
|
}
|
|
}
|
|
|
|
// DefaultLibrarySections returns the minimal fallback sections for libraries
|
|
// with no admin-configured sections. This remains available as a degraded-path
|
|
// fallback when typed defaults cannot be resolved safely.
|
|
func DefaultLibrarySections(libraryID *int) []*PageSection {
|
|
emptyCfg := json.RawMessage(`{}`)
|
|
return []*PageSection{
|
|
{ID: "default-continue-watching", Scope: "library", LibraryID: libraryID, Position: 0, SectionType: SectionContinueWatching, Title: "Continue Watching", ItemLimit: 20, Config: ContinueTypeConfig(ContinueTypeWatching), Enabled: true},
|
|
{ID: "default-recently-added", Scope: "library", LibraryID: libraryID, Position: 1, SectionType: SectionRecentlyAdded, Title: "Recently Added", ItemLimit: 20, Config: emptyCfg, Enabled: true},
|
|
{ID: "default-recently-released", Scope: "library", LibraryID: libraryID, Position: 2, SectionType: SectionRecentlyReleased, Title: "Recently Released", ItemLimit: 20, Config: emptyCfg, Enabled: true},
|
|
}
|
|
}
|