feat(series): add SeriesHandler, API routes, and SSR browse page

Create SeriesHandler with two API endpoints: - GET /api/series (paginated series list with covers) - GET /api/series/books (books in a specific series) Uses query param ?name=X instead of path param to avoid URL encoding issues with special characters in series names. Add GetSeriesCardsData helper returning services.SeriesInfo for use by the SSR route (avoids handlers→templates import cycle). Register /api/series routes via registerSeriesRoutes in router. Add /series SSR route in frontend.go with library-scoped pagination and error handling, matching the dashboard/bookshelf patterns. Add SeriesHandler to router Config and instantiate in main.go. Add SeriesCardData type to templates/types.go. Add Continue Series as the 5th valid system collection in dashboard handler and auth handler's CreateDefaultCollectionsForUser.
2026-05-08 20:27:01 -04:00
parent 9405afa2c5
commit 004b761381
8 changed files with 241 additions and 0 deletions
@@ -119,6 +119,100 @@ func registerFrontendRoutes(cfg *Config) {
 		return ""
 	}

+	// Series browse page
+	frontendProtected.GET("/series", func(c *echo.Context) error {
+		user, err := getTemplateUserWithTheme(c, cfg)
+		if err != nil {
+			return renderErrorPage(c, "Error loading user", "user_load_error")
+		}
+
+		var errorMsg string
+
+		libraryID := c.QueryParam("library_id")
+		userUUID, _ := uuid.Parse(user.ID)
+		if libraryID == "" {
+			libraries, err := cfg.Queries.GetUserVisibleLibraries(c.Request().Context(), uuidToPGType(userUUID))
+			if err == nil && len(libraries) > 0 {
+				libUUID, _ := uuid.FromBytes(libraries[0].ID.Bytes[0:16])
+				libraryID = libUUID.String()
+			} else {
+				errorMsg = "No libraries available"
+			}
+		}
+
+		libraries, err := cfg.Queries.GetUserVisibleLibraries(c.Request().Context(), uuidToPGType(userUUID))
+		if err != nil {
+			log.Printf("GetUserVisibleLibraries failed: %v", err)
+			libraries = []database.GetUserVisibleLibrariesRow{}
+			if errorMsg == "" {
+				errorMsg = "Error loading libraries"
+			}
+		}
+
+		libData := make([]templates.LibraryData, len(libraries))
+		for i, lib := range libraries {
+			libUUID, _ := uuid.FromBytes(lib.ID.Bytes[0:16])
+			libData[i] = templates.LibraryData{
+				ID:          libUUID.String(),
+				Name:        lib.Name,
+				Description: getText(lib.Description),
+				TypeName:    lib.TypeName,
+			}
+		}
+
+		perSeriesPage := 24
+		page := 1
+		if p := c.QueryParam("page"); p != "" {
+			if v, err := strconv.Atoi(p); err == nil && v > 0 {
+				page = v
+			}
+		}
+		offset := (page - 1) * perSeriesPage
+
+		var seriesCards []templates.SeriesCardData
+		totalPages := 1
+
+		if libraryID != "" && errorMsg == "" {
+			libUUID, err := uuid.Parse(libraryID)
+			if err == nil {
+				seriesList, total, err := handlers.GetSeriesCardsData(c.Request().Context(), cfg.Queries, libUUID, perSeriesPage, offset)
+				if err != nil {
+					log.Printf("GetSeriesCardsData failed: %v", err)
+					errorMsg = "Error loading series"
+				} else {
+					totalPages = (total + perSeriesPage - 1) / perSeriesPage
+					if totalPages < 1 {
+						totalPages = 1
+					}
+					seriesCards = make([]templates.SeriesCardData, 0, len(seriesList))
+					for _, s := range seriesList {
+						covers := s.CoverPaths
+						if covers == nil {
+							covers = []string{}
+						}
+						seriesCards = append(seriesCards, templates.SeriesCardData{
+							Name:          s.Name,
+							BookCount:     s.BookCount,
+							TotalInSeries: s.TotalInSeries,
+							CoverPaths:    covers,
+						})
+					}
+				}
+			}
+		}
+
+		if seriesCards == nil {
+			seriesCards = []templates.SeriesCardData{}
+		}
+
+		var buf bytes.Buffer
+		err = templates.Series(user, seriesCards, libData, libraryID, totalPages, page, errorMsg).Render(c.Request().Context(), &buf)
+		if err != nil {
+			return err
+		}
+		return c.HTML(http.StatusOK, buf.String())
+	})
+
 	frontendProtected.GET("/bookshelf", func(c *echo.Context) error {
 		user, err := getTemplateUserWithTheme(c, cfg)
 		if err != nil {