Add e-book sidecar integration and improve request handling

Introduces optional e-book sidecar downloads from Anna's Archive, including admin UI, settings API, FlareSolverr integration, and documentation. Enhances request creation logic to prevent duplicate downloads by checking for 'downloaded' and 'available' statuses, updates UI to reflect processing state, and adds SABnzbd support to download and cleanup flows. Also updates ranking algorithm documentation and improves cache invalidation for recent requests.

src/app/api/requests/[id]/route.ts

@@ -194,11 +194,39 @@ export async function PATCH(
 
           const downloadHistory = requestWithData.downloadHistory[0];
 
-          // Get download path from qBittorrent
-          const { getQBittorrentService } = await import('@/lib/integrations/qbittorrent.service');
-          const qbt = await getQBittorrentService();
-          const torrent = await qbt.getTorrent(downloadHistory.downloadClientId!);
-          const downloadPath = `${torrent.save_path}/${torrent.name}`;
+          // Get download path from the appropriate download client
+          let downloadPath: string;
+
+          if (downloadHistory.torrentHash) {
+            // qBittorrent - get path from torrent info
+            const { getQBittorrentService } = await import('@/lib/integrations/qbittorrent.service');
+            const qbt = await getQBittorrentService();
+            const torrent = await qbt.getTorrent(downloadHistory.torrentHash);
+            downloadPath = `${torrent.save_path}/${torrent.name}`;
+          } else if (downloadHistory.nzbId) {
+            // SABnzbd - get path from NZB info
+            const { getSABnzbdService } = await import('@/lib/integrations/sabnzbd.service');
+            const sabnzbd = await getSABnzbdService();
+            const nzbInfo = await sabnzbd.getNZB(downloadHistory.nzbId);
+            if (!nzbInfo || !nzbInfo.downloadPath) {
+              return NextResponse.json(
+                {
+                  error: 'ValidationError',
+                  message: 'Download path not available from SABnzbd',
+                },
+                { status: 400 }
+              );
+            }
+            downloadPath = nzbInfo.downloadPath;
+          } else {
+            return NextResponse.json(
+              {
+                error: 'ValidationError',
+                message: 'No download client ID found in history',
+              },
+              { status: 400 }
+            );
+          }
 
           await jobQueue.addOrganizeJob(
             id,

src/app/api/requests/route.ts

@@ -41,7 +41,40 @@ export async function POST(request: NextRequest) {
       const body = await req.json();
       const { audiobook } = CreateRequestSchema.parse(body);
 
-      // Check if audiobook is already available in Plex library
+      // First check: Is there an existing request in 'downloaded' or 'available' status?
+      // This catches the gap where files are organized but Plex hasn't scanned yet
+      const existingActiveRequest = await prisma.request.findFirst({
+        where: {
+          audiobook: {
+            audibleAsin: audiobook.asin,
+          },
+          status: { in: ['downloaded', 'available'] },
+          deletedAt: null,
+        },
+        include: {
+          user: { select: { plexUsername: true } },
+        },
+      });
+
+      if (existingActiveRequest) {
+        const status = existingActiveRequest.status;
+        const isOwnRequest = existingActiveRequest.userId === req.user.id;
+
+        return NextResponse.json(
+          {
+            error: status === 'available' ? 'AlreadyAvailable' : 'BeingProcessed',
+            message: status === 'available'
+              ? 'This audiobook is already available in your Plex library'
+              : 'This audiobook is being processed and will be available soon',
+            requestStatus: status,
+            isOwnRequest,
+            requestedBy: existingActiveRequest.user?.plexUsername,
+          },
+          { status: 409 }
+        );
+      }
+
+      // Second check: Is audiobook already in Plex library? (fallback for non-requested books)
       const plexMatch = await findPlexMatch({
         asin: audiobook.asin,
         title: audiobook.title,