feat: add sort parameter (title/latest) to books and series endpoints

Add sort=latest option to GET /books and GET /series API endpoints,
and expose a Sort select in the backoffice books and series pages.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Cargo.lock

@@ -51,7 +51,7 @@ checksum = "7f202df86484c868dbad7eaa557ef785d5c66295e41b460ef922eca0723b842c"
 
 [[package]]
 name = "api"
-version = "0.3.0"
+version = "1.0.0"
 dependencies = [
  "anyhow",
  "argon2",
@@ -1122,7 +1122,7 @@ dependencies = [
 
 [[package]]
 name = "indexer"
-version = "0.3.0"
+version = "1.0.0"
 dependencies = [
  "anyhow",
  "axum",
@@ -1624,7 +1624,7 @@ dependencies = [
 
 [[package]]
 name = "parsers"
-version = "0.3.0"
+version = "1.0.0"
 dependencies = [
  "anyhow",
  "flate2",
@@ -2626,7 +2626,7 @@ dependencies = [
 
 [[package]]
 name = "stripstream-core"
-version = "0.3.0"
+version = "1.0.0"
 dependencies = [
  "anyhow",
  "serde",

Cargo.toml

@@ -9,7 +9,7 @@ resolver = "2"
 
 [workspace.package]
 edition = "2021"
-version = "0.3.0"
+version = "1.0.0"
 license = "MIT"
 
 [workspace.dependencies]

apps/api/src/books.rs

@@ -23,6 +23,9 @@ pub struct ListBooksQuery {
     pub page: Option<i64>,
     #[schema(value_type = Option<i64>, example = 50)]
     pub limit: Option<i64>,
+    /// Sort order: "title" (default) or "latest" (most recently added first)
+    #[schema(value_type = Option<String>, example = "latest")]
+    pub sort: Option<String>,
 }
 
 #[derive(Serialize, ToSchema)]
@@ -93,6 +96,7 @@ pub struct BookDetails {
         ("reading_status" = Option<String>, Query, description = "Filter by reading status, comma-separated (e.g. 'unread,reading')"),
         ("page" = Option<i64>, Query, description = "Page number (1-indexed, default 1)"),
         ("limit" = Option<i64>, Query, description = "Items per page (max 200, default 50)"),
+        ("sort" = Option<String>, Query, description = "Sort order: 'title' (default) or 'latest' (most recently added first)"),
     ),
     responses(
         (status = 200, body = BooksPage),
@@ -134,6 +138,12 @@ pub async fn list_books(
              {rs_cond}"#
     );
 
+    let order_clause = if query.sort.as_deref() == Some("latest") {
+        "b.updated_at DESC".to_string()
+    } else {
+        "REGEXP_REPLACE(LOWER(b.title), '[0-9]+', '', 'g'), COALESCE((REGEXP_MATCH(LOWER(b.title), '\\d+'))[1]::int, 0), b.title ASC".to_string()
+    };
+
     // DATA: mêmes params filtre, puis $N+1=limit $N+2=offset
     let limit_p = p + 1;
     let offset_p = p + 2;
@@ -150,13 +160,7 @@ pub async fn list_books(
           AND ($3::text IS NULL OR b.format = $3)
           {series_cond}
           {rs_cond}
-        ORDER BY
-            REGEXP_REPLACE(LOWER(b.title), '[0-9]+', '', 'g'),
-            COALESCE(
-                (REGEXP_MATCH(LOWER(b.title), '\d+'))[1]::int,
-                0
-            ),
-            b.title ASC
+        ORDER BY {order_clause}
         LIMIT ${limit_p} OFFSET ${offset_p}
         "#
     );
@@ -486,6 +490,9 @@ pub struct ListAllSeriesQuery {
     pub page: Option<i64>,
     #[schema(value_type = Option<i64>, example = 50)]
     pub limit: Option<i64>,
+    /// Sort order: "title" (default) or "latest" (most recently added first)
+    #[schema(value_type = Option<String>, example = "latest")]
+    pub sort: Option<String>,
 }
 
 /// List all series across libraries with optional filtering and pagination
@@ -499,6 +506,7 @@ pub struct ListAllSeriesQuery {
         ("reading_status" = Option<String>, Query, description = "Filter by reading status, comma-separated (e.g. 'unread,reading')"),
         ("page" = Option<i64>, Query, description = "Page number (1-indexed, default 1)"),
         ("limit" = Option<i64>, Query, description = "Items per page (max 200, default 50)"),
+        ("sort" = Option<String>, Query, description = "Sort order: 'title' (default) or 'latest' (most recently added first)"),
     ),
     responses(
         (status = 200, body = SeriesPage),
@@ -558,6 +566,12 @@ pub async fn list_all_series(
         "#
     );
 
+    let series_order_clause = if query.sort.as_deref() == Some("latest") {
+        "sc.latest_updated_at DESC".to_string()
+    } else {
+        "REGEXP_REPLACE(LOWER(sc.name), '[0-9]+', '', 'g'), COALESCE((REGEXP_MATCH(LOWER(sc.name), '\\d+'))[1]::int, 0), sc.name ASC".to_string()
+    };
+
     let limit_p = p + 1;
     let offset_p = p + 2;
 
@@ -568,6 +582,7 @@ pub async fn list_all_series(
                 COALESCE(NULLIF(series, ''), 'unclassified') as name,
                 id,
                 library_id,
+                updated_at,
                 ROW_NUMBER() OVER (
                     PARTITION BY COALESCE(NULLIF(series, ''), 'unclassified')
                     ORDER BY
@@ -582,7 +597,8 @@ pub async fn list_all_series(
             SELECT
                 sb.name,
                 COUNT(*) as book_count,
-                COUNT(brp.book_id) FILTER (WHERE brp.status = 'read') as books_read_count
+                COUNT(brp.book_id) FILTER (WHERE brp.status = 'read') as books_read_count,
+                MAX(sb.updated_at) as latest_updated_at
             FROM sorted_books sb
             LEFT JOIN book_reading_progress brp ON brp.book_id = sb.id
             GROUP BY sb.name
@@ -598,13 +614,7 @@ pub async fn list_all_series(
         WHERE TRUE
           {q_cond}
           {rs_cond}
-        ORDER BY
-            REGEXP_REPLACE(LOWER(sc.name), '[0-9]+', '', 'g'),
-            COALESCE(
-                (REGEXP_MATCH(LOWER(sc.name), '\d+'))[1]::int,
-                0
-            ),
-            sc.name ASC
+        ORDER BY {series_order_clause}
         LIMIT ${limit_p} OFFSET ${offset_p}
         "#
     );

apps/backoffice/app/books/page.tsx

@@ -16,6 +16,7 @@ export default async function BooksPage({
   const libraryId = typeof searchParamsAwaited.library === "string" ? searchParamsAwaited.library : undefined;
   const searchQuery = typeof searchParamsAwaited.q === "string" ? searchParamsAwaited.q : "";
   const readingStatus = typeof searchParamsAwaited.status === "string" ? searchParamsAwaited.status : undefined;
+  const sort = typeof searchParamsAwaited.sort === "string" ? searchParamsAwaited.sort : undefined;
   const page = typeof searchParamsAwaited.page === "string" ? parseInt(searchParamsAwaited.page) : 1;
   const limit = typeof searchParamsAwaited.limit === "string" ? parseInt(searchParamsAwaited.limit) : 20;
 
@@ -54,7 +55,7 @@ export default async function BooksPage({
       totalHits = searchResponse.estimated_total_hits;
     }
   } else {
-    const booksPage = await fetchBooks(libraryId, undefined, page, limit, readingStatus).catch(() => ({
+    const booksPage = await fetchBooks(libraryId, undefined, page, limit, readingStatus, sort).catch(() => ({
       items: [] as BookDto[],
       total: 0,
       page: 1,
@@ -83,7 +84,12 @@ export default async function BooksPage({
     { value: "read", label: "Read" },
   ];
 
-  const hasFilters = searchQuery || libraryId || readingStatus;
+  const sortOptions = [
+    { value: "", label: "Title" },
+    { value: "latest", label: "Latest added" },
+  ];
+
+  const hasFilters = searchQuery || libraryId || readingStatus || sort;
 
   return (
     <>
@@ -104,6 +110,7 @@ export default async function BooksPage({
               { name: "q", type: "text", label: "Search", placeholder: "Search by title, author, series...", className: "flex-1 w-full" },
               { name: "library", type: "select", label: "Library", options: libraryOptions, className: "w-full sm:w-48" },
               { name: "status", type: "select", label: "Status", options: statusOptions, className: "w-full sm:w-40" },
+              { name: "sort", type: "select", label: "Sort", options: sortOptions, className: "w-full sm:w-40" },
             ]}
           />
         </CardContent>

apps/backoffice/app/series/page.tsx

@@ -16,19 +16,25 @@ export default async function SeriesPage({
   const libraryId = typeof searchParamsAwaited.library === "string" ? searchParamsAwaited.library : undefined;
   const searchQuery = typeof searchParamsAwaited.q === "string" ? searchParamsAwaited.q : "";
   const readingStatus = typeof searchParamsAwaited.status === "string" ? searchParamsAwaited.status : undefined;
+  const sort = typeof searchParamsAwaited.sort === "string" ? searchParamsAwaited.sort : undefined;
   const page = typeof searchParamsAwaited.page === "string" ? parseInt(searchParamsAwaited.page) : 1;
   const limit = typeof searchParamsAwaited.limit === "string" ? parseInt(searchParamsAwaited.limit) : 20;
 
   const [libraries, seriesPage] = await Promise.all([
     fetchLibraries().catch(() => [] as LibraryDto[]),
-    fetchAllSeries(libraryId, searchQuery || undefined, readingStatus, page, limit).catch(
+    fetchAllSeries(libraryId, searchQuery || undefined, readingStatus, page, limit, sort).catch(
       () => ({ items: [] as SeriesDto[], total: 0, page: 1, limit }) as SeriesPageDto
     ),
   ]);
 
   const series = seriesPage.items;
   const totalPages = Math.ceil(seriesPage.total / limit);
-  const hasFilters = searchQuery || libraryId || readingStatus;
+  const sortOptions = [
+    { value: "", label: "Title" },
+    { value: "latest", label: "Latest added" },
+  ];
+
+  const hasFilters = searchQuery || libraryId || readingStatus || sort;
 
   const libraryOptions = [
     { value: "", label: "All libraries" },
@@ -61,6 +67,7 @@ export default async function SeriesPage({
               { name: "q", type: "text", label: "Search", placeholder: "Search by series name...", className: "flex-1 w-full" },
               { name: "library", type: "select", label: "Library", options: libraryOptions, className: "w-full sm:w-48" },
               { name: "status", type: "select", label: "Status", options: statusOptions, className: "w-full sm:w-40" },
+              { name: "sort", type: "select", label: "Sort", options: sortOptions, className: "w-full sm:w-40" },
             ]}
           />
         </CardContent>

apps/backoffice/lib/api.ts

@@ -265,11 +265,13 @@ export async function fetchBooks(
   page: number = 1,
   limit: number = 50,
   readingStatus?: string,
+  sort?: string,
 ): Promise<BooksPageDto> {
   const params = new URLSearchParams();
   if (libraryId) params.set("library_id", libraryId);
   if (series) params.set("series", series);
   if (readingStatus) params.set("reading_status", readingStatus);
+  if (sort) params.set("sort", sort);
   params.set("page", page.toString());
   params.set("limit", limit.toString());
 
@@ -303,11 +305,13 @@ export async function fetchAllSeries(
   readingStatus?: string,
   page: number = 1,
   limit: number = 50,
+  sort?: string,
 ): Promise<SeriesPageDto> {
   const params = new URLSearchParams();
   if (libraryId) params.set("library_id", libraryId);
   if (q) params.set("q", q);
   if (readingStatus) params.set("reading_status", readingStatus);
+  if (sort) params.set("sort", sort);
   params.set("page", page.toString());
   params.set("limit", limit.toString());
 

apps/backoffice/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stripstream-backoffice",
-  "version": "0.3.0",
+  "version": "1.0.0",
   "private": true,
   "scripts": {
     "dev": "next dev -p 7082",