feat: update media filter to support multiple series names and enhance library item fetching

k-tv-backend/api/Cargo.toml

@@ -34,6 +34,7 @@ tokio = { version = "1.48.0", features = ["full"] }
 # Serialization
 serde = { version = "1.0.228", features = ["derive"] }
 serde_json = "1.0"
+serde_qs = "0.13"
 
 # Error handling
 thiserror = "2.0.17"

k-tv-backend/api/src/routes/library.rs

@@ -11,7 +11,7 @@
 
 use axum::{
     Json, Router,
-    extract::{Query, State},
+    extract::{Query, RawQuery, State},
     routing::get,
 };
 use serde::{Deserialize, Serialize};
@@ -106,15 +106,17 @@ struct GenresQuery {
     content_type: Option<String>,
 }
 
-#[derive(Debug, Deserialize)]
+#[derive(Debug, Default, Deserialize)]
 struct ItemsQuery {
     /// Free-text search.
     q: Option<String>,
     /// Content type filter: "movie", "episode", or "short".
     #[serde(rename = "type")]
     content_type: Option<String>,
-    /// Filter episodes to a specific series name.
-    series: Option<String>,
+    /// Filter episodes by series name. Repeat the param for multiple series:
+    /// `?series=iCarly&series=Victorious`
+    #[serde(default)]
+    series: Vec<String>,
     /// Scope to a provider collection ID.
     collection: Option<String>,
     /// Maximum number of results (default: 50, max: 200).
@@ -163,14 +165,21 @@ async fn list_genres(
 async fn search_items(
     State(state): State<AppState>,
     CurrentUser(_user): CurrentUser,
-    Query(params): Query<ItemsQuery>,
+    RawQuery(raw_query): RawQuery,
 ) -> Result<Json<Vec<LibraryItemResponse>>, ApiError> {
+    let qs_config = serde_qs::Config::new(2, false); // non-strict: accept encoded brackets
+    let params: ItemsQuery = raw_query
+        .as_deref()
+        .map(|q| qs_config.deserialize_str::<ItemsQuery>(q))
+        .transpose()
+        .map_err(|e| ApiError::validation(e.to_string()))?
+        .unwrap_or_default();
     let limit = params.limit.unwrap_or(50).min(200);
 
     let filter = MediaFilter {
         content_type: parse_content_type(params.content_type.as_deref())?,
         search_term: params.q,
-        series_name: params.series,
+        series_names: params.series,
         collections: params
             .collection
             .map(|c| vec![c])