Add interactive ebook search & selection

Introduce interactive ebook support: adds two API endpoints to search (interactive-search-ebook) and create/select ebook requests (select-ebook), plus server-side handlers to route Anna's Archive (direct) and indexer (torrent/NZB) downloads. Frontend: extend RequestActionsDropdown and InteractiveTorrentSearchModal to support an "ebook" search mode and selection flow, and add hooks (useInteractiveSearchEbook / useSelectEbook). Settings: add ebook_auto_grab_enabled with UI toggle and enforce disabling when no ebook sources are enabled; settings GET/PUT updated to persist the flag (default = true to preserve behavior). Documentation updated (scheduler, ebook-sidecar, settings pages) and ranking algorithm docs/tests extended to cover ebook-related normalization and matching cases. Includes logging and ranking integration for indexer results and normalization for Anna's Archive handling.

src/lib/processors/monitor-rss-feeds.processor.ts

@@ -2,7 +2,7 @@
  * Component: Monitor RSS Feeds Processor
  * Documentation: documentation/backend/services/scheduler.md
  *
- * Monitors RSS feeds for new audiobook releases and matches against missing requests
+ * Monitors RSS feeds for new releases and matches against missing requests (audiobooks and ebooks)
  */
 
 import { prisma } from '../db';
@@ -57,11 +57,10 @@ export async function processMonitorRssFeeds(payload: MonitorRssFeedsPayload): P
     return { success: true, message: 'No RSS results', matched: 0 };
   }
 
-  // Get all active audiobook requests awaiting search (missing audiobooks)
-  // Note: RSS feeds are for torrents, so only audiobook requests are matched
+  // Get all active requests awaiting search (audiobooks and ebooks)
+  // Both types can be matched against RSS torrent feeds
   const missingRequests = await prisma.request.findMany({
     where: {
-      type: 'audiobook', // Only audiobook requests (RSS feeds are for torrents)
       status: 'awaiting_search',
       deletedAt: null,
     },
@@ -75,7 +74,7 @@ export async function processMonitorRssFeeds(payload: MonitorRssFeedsPayload): P
     return { success: true, message: 'No missing requests', matched: 0 };
   }
 
-  // Match RSS results against missing audiobooks
+  // Match RSS results against missing requests
   let matched = 0;
   const jobQueue = getJobQueueService();
 
@@ -96,16 +95,27 @@ export async function processMonitorRssFeeds(payload: MonitorRssFeedsPayload): P
       if (hasAuthor && titleMatchCount >= 2) {
         logger.info(`Match found! "${audiobook.title}" by ${audiobook.author} matches torrent: ${torrent.title}`);
 
-        // Trigger search job to process this request
+        // Trigger appropriate search job based on request type
         try {
-          await jobQueue.addSearchJob(request.id, {
-            id: audiobook.id,
-            title: audiobook.title,
-            author: audiobook.author,
-            asin: audiobook.audibleAsin || undefined,
-          });
-          matched++;
-          logger.info(`Triggered search job for request ${request.id}`);
+          if (request.type === 'ebook') {
+            await jobQueue.addSearchEbookJob(request.id, {
+              id: audiobook.id,
+              title: audiobook.title,
+              author: audiobook.author,
+              asin: audiobook.audibleAsin || undefined,
+            });
+            matched++;
+            logger.info(`Triggered ebook search job for request ${request.id}`);
+          } else {
+            await jobQueue.addSearchJob(request.id, {
+              id: audiobook.id,
+              title: audiobook.title,
+              author: audiobook.author,
+              asin: audiobook.audibleAsin || undefined,
+            });
+            matched++;
+            logger.info(`Triggered audiobook search job for request ${request.id}`);
+          }
         } catch (error) {
           logger.error(`Failed to trigger search for request ${request.id}: ${error instanceof Error ? error.message : 'Unknown error'}`);
         }

src/lib/processors/organize-files.processor.ts

@@ -785,8 +785,16 @@ async function createEbookRequestIfEnabled(
   logger: RMABLogger
 ): Promise<void> {
   try {
-    // Check which ebook sources are enabled
     const configService = getConfigService();
+
+    // Check if auto-grab is enabled (default: true for backward compatibility)
+    const autoGrabEnabled = await configService.get('ebook_auto_grab_enabled');
+    if (autoGrabEnabled === 'false') {
+      logger.info('Ebook auto-grab disabled, skipping automatic ebook request creation');
+      return;
+    }
+
+    // Check which ebook sources are enabled
     const annasArchiveEnabled = await configService.get('ebook_annas_archive_enabled');
     const indexerSearchEnabled = await configService.get('ebook_indexer_search_enabled');
 

src/lib/processors/retry-missing-torrents.processor.ts

@@ -21,11 +21,9 @@ export async function processRetryMissingTorrents(payload: RetryMissingTorrentsP
   logger.info('Starting retry job for requests awaiting search...');
 
   try {
-    // Find all active audiobook requests in awaiting_search status
-    // Note: Ebook requests have separate search mechanism (search_ebook job)
+    // Find all active requests (audiobook or ebook) in awaiting_search status
     const requests = await prisma.request.findMany({
       where: {
-        type: 'audiobook', // Only audiobook requests (ebooks use different search)
         status: 'awaiting_search',
         deletedAt: null,
       },
@@ -45,20 +43,33 @@ export async function processRetryMissingTorrents(payload: RetryMissingTorrentsP
       };
     }
 
-    // Trigger search job for each request
+    // Trigger appropriate search job for each request based on type
     const jobQueue = getJobQueueService();
     let triggered = 0;
 
     for (const request of requests) {
       try {
-        await jobQueue.addSearchJob(request.id, {
-          id: request.audiobook.id,
-          title: request.audiobook.title,
-          author: request.audiobook.author,
-          asin: request.audiobook.audibleAsin || undefined,
-        });
-        triggered++;
-        logger.info(`Triggered search for request ${request.id}: ${request.audiobook.title}`);
+        if (request.type === 'ebook') {
+          // Ebook requests use ebook search (Anna's Archive, etc.)
+          await jobQueue.addSearchEbookJob(request.id, {
+            id: request.audiobook.id,
+            title: request.audiobook.title,
+            author: request.audiobook.author,
+            asin: request.audiobook.audibleAsin || undefined,
+          });
+          triggered++;
+          logger.info(`Triggered ebook search for request ${request.id}: ${request.audiobook.title}`);
+        } else {
+          // Audiobook requests use indexer search (Prowlarr)
+          await jobQueue.addSearchJob(request.id, {
+            id: request.audiobook.id,
+            title: request.audiobook.title,
+            author: request.audiobook.author,
+            asin: request.audiobook.audibleAsin || undefined,
+          });
+          triggered++;
+          logger.info(`Triggered audiobook search for request ${request.id}: ${request.audiobook.title}`);
+        }
       } catch (error) {
         logger.error(`Failed to trigger search for request ${request.id}: ${error instanceof Error ? error.message : 'Unknown error'}`);
       }