Add admin request deletion with soft delete and cleanup

Implements admin ability to delete requests with soft delete, media file cleanup, and seeding-aware torrent management. Adds new API endpoint, frontend confirmation dialog, and request actions dropdown. Updates database schema with deletedAt and deletedBy fields, and ensures all queries filter out deleted requests. Documentation added for feature and user flow.

src/lib/processors/cleanup-seeded-torrents.processor.ts

@@ -44,10 +44,20 @@ export async function processCleanupSeededTorrents(payload: CleanupSeededTorrent
 
     await logger?.info(`Loaded configuration for ${indexerConfigMap.size} indexers`);
 
-    // Find all completed requests that have download history
+    // Find all completed requests + soft-deleted requests (orphaned downloads)
     const completedRequests = await prisma.request.findMany({
       where: {
-        status: { in: ['available', 'downloaded'] },
+        OR: [
+          // Active requests with completed downloads
+          {
+            status: { in: ['available', 'downloaded'] },
+            deletedAt: null,
+          },
+          // Soft-deleted requests (orphaned downloads still seeding)
+          {
+            deletedAt: { not: null },
+          },
+        ],
       },
       include: {
         downloadHistory: {
@@ -82,13 +92,13 @@ export async function processCleanupSeededTorrents(payload: CleanupSeededTorrent
         // Find matching indexer configuration by name
         const seedingConfig = indexerConfigMap.get(indexerName);
 
-        // If no config found or seeding time is 0 (unlimited), skip
-        if (!seedingConfig) {
-          noConfig++;
-          continue;
-        }
-
-        if (seedingConfig.seedingTimeMinutes === 0) {
+        // If no config found or seeding time is 0 (unlimited)
+        if (!seedingConfig || seedingConfig.seedingTimeMinutes === 0) {
+          // For soft-deleted requests with unlimited seeding, hard delete immediately
+          if (request.deletedAt) {
+            await prisma.request.delete({ where: { id: request.id } });
+            await logger?.info(`Hard-deleted orphaned request ${request.id} with unlimited seeding`);
+          }
           noConfig++;
           continue;
         }
@@ -122,7 +132,14 @@ export async function processCleanupSeededTorrents(payload: CleanupSeededTorrent
         // Delete torrent and files from qBittorrent
         await qbt.deleteTorrent(downloadHistory.downloadClientId, true); // true = delete files
 
-        await logger?.info(`Deleted torrent and files for request ${request.id}`);
+        // If this is a soft-deleted request (orphaned download), hard delete it now
+        if (request.deletedAt) {
+          await prisma.request.delete({ where: { id: request.id } });
+          await logger?.info(`Hard-deleted orphaned request ${request.id} after torrent cleanup`);
+        } else {
+          await logger?.info(`Deleted torrent and files for active request ${request.id}`);
+        }
+
         cleaned++;
       } catch (error) {
         await logger?.error(`Failed to cleanup request ${request.id}: ${error instanceof Error ? error.message : 'Unknown error'}`);

src/lib/processors/monitor-download.processor.ts

@@ -106,15 +106,18 @@ export async function processMonitorDownload(payload: MonitorDownloadPayload): P
       });
 
       // Get request with audiobook details
-      const request = await prisma.request.findUnique({
-        where: { id: requestId },
+      const request = await prisma.request.findFirst({
+        where: {
+          id: requestId,
+          deletedAt: null,
+        },
         include: {
           audiobook: true,
         },
       });
 
       if (!request || !request.audiobook) {
-        throw new Error('Request or audiobook not found');
+        throw new Error('Request or audiobook not found or deleted');
       }
 
       // Trigger organize files job (target path determined by database config)

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

@@ -57,9 +57,12 @@ export async function processMonitorRssFeeds(payload: MonitorRssFeedsPayload): P
     return { success: true, message: 'No RSS results', matched: 0 };
   }
 
-  // Get all requests awaiting search (missing audiobooks)
+  // Get all active requests awaiting search (missing audiobooks)
   const missingRequests = await prisma.request.findMany({
-    where: { status: 'awaiting_search' },
+    where: {
+      status: 'awaiting_search',
+      deletedAt: null,
+    },
     include: { audiobook: true },
     take: 100,
   });

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

@@ -114,25 +114,33 @@ export async function processOrganizeFiles(payload: OrganizeFilesPayload): Promi
 
     const errorMessage = error instanceof Error ? error.message : 'File organization failed';
 
-    // Check if this is a "no files found" error that should be retried
-    const isNoFilesError = errorMessage.includes('No audiobook files found');
+    // Check if this is a retryable error (transient filesystem issues or no files found)
+    const isRetryableError =
+      errorMessage.includes('No audiobook files found') ||
+      errorMessage.includes('ENOENT') || // File/directory not found
+      errorMessage.includes('no such file or directory') ||
+      errorMessage.includes('EACCES') || // Permission denied (might be temporary)
+      errorMessage.includes('EPERM');    // Operation not permitted (might be temporary)
 
-    if (isNoFilesError) {
+    if (isRetryableError) {
       // Get current request to check retry count
-      const currentRequest = await prisma.request.findUnique({
-        where: { id: requestId },
+      const currentRequest = await prisma.request.findFirst({
+        where: {
+          id: requestId,
+          deletedAt: null,
+        },
         select: { importAttempts: true, maxImportRetries: true },
       });
 
       if (!currentRequest) {
-        throw new Error('Request not found');
+        throw new Error('Request not found or deleted');
       }
 
       const newAttempts = currentRequest.importAttempts + 1;
 
       if (newAttempts < currentRequest.maxImportRetries) {
         // Still have retries left - queue for re-import
-        await logger?.warn(`No files found for request ${requestId}, queueing for retry (attempt ${newAttempts}/${currentRequest.maxImportRetries})`);
+        await logger?.warn(`Retryable error for request ${requestId}, queueing for retry (attempt ${newAttempts}/${currentRequest.maxImportRetries})`);
 
         await prisma.request.update({
           where: { id: requestId },
@@ -147,7 +155,7 @@ export async function processOrganizeFiles(payload: OrganizeFilesPayload): Promi
 
         return {
           success: false,
-          message: 'No audiobook files found, queued for re-import',
+          message: 'Retryable error detected, queued for re-import',
           requestId,
           attempts: newAttempts,
           maxRetries: currentRequest.maxImportRetries,

src/lib/processors/plex-recently-added.processor.ts

@@ -135,7 +135,10 @@ export async function processPlexRecentlyAddedCheck(payload: PlexRecentlyAddedPa
 
     // Check for downloaded requests to match
     const downloadedRequests = await prisma.request.findMany({
-      where: { status: 'downloaded' },
+      where: {
+        status: 'downloaded',
+        deletedAt: null,
+      },
       include: { audiobook: true },
       take: 50,
     });

src/lib/processors/retry-failed-imports.processor.ts

@@ -8,6 +8,7 @@
 import { prisma } from '../db';
 import { createJobLogger } from '../utils/job-logger';
 import { getJobQueueService } from '../services/job-queue.service';
+import { getConfigService } from '../services/config.service';
 
 export interface RetryFailedImportsPayload {
   jobId?: string;
@@ -21,10 +22,11 @@ export async function processRetryFailedImports(payload: RetryFailedImportsPaylo
   await logger?.info('Starting retry job for requests awaiting import...');
 
   try {
-    // Find all requests in awaiting_import status
+    // Find all active requests in awaiting_import status
     const requests = await prisma.request.findMany({
       where: {
         status: 'awaiting_import',
+        deletedAt: null,
       },
       include: {
         audiobook: true,
@@ -57,17 +59,64 @@ export async function processRetryFailedImports(payload: RetryFailedImportsPaylo
         // Get the download path from the most recent download history
         const downloadHistory = request.downloadHistory[0];
 
-        if (!downloadHistory || !downloadHistory.downloadClientId) {
+        if (!downloadHistory) {
           await logger?.warn(`No download history found for request ${request.id}, skipping`);
           skipped++;
           continue;
         }
 
-        // Get download path from qBittorrent
-        const { getQBittorrentService } = await import('../integrations/qbittorrent.service');
-        const qbt = await getQBittorrentService();
-        const torrent = await qbt.getTorrent(downloadHistory.downloadClientId);
-        const downloadPath = `${torrent.save_path}/${torrent.name}`;
+        let downloadPath: string;
+
+        // Try to get download path from qBittorrent if we have the torrent
+        if (downloadHistory.downloadClientId) {
+          try {
+            const { getQBittorrentService } = await import('../integrations/qbittorrent.service');
+            const qbt = await getQBittorrentService();
+            const torrent = await qbt.getTorrent(downloadHistory.downloadClientId);
+            downloadPath = `${torrent.save_path}/${torrent.name}`;
+            await logger?.info(`Got download path from qBittorrent for request ${request.id}: ${downloadPath}`);
+          } catch (qbtError) {
+            // Torrent not found in qBittorrent - try to construct path from config
+            await logger?.warn(`Torrent not found in qBittorrent for request ${request.id}, falling back to configured path`);
+
+            if (!downloadHistory.torrentName) {
+              await logger?.warn(`No torrent name stored for request ${request.id}, cannot construct fallback path, skipping`);
+              skipped++;
+              continue;
+            }
+
+            const configService = getConfigService();
+            const downloadDir = await configService.get('download_dir');
+
+            if (!downloadDir) {
+              await logger?.error(`download_dir not configured, cannot retry request ${request.id}, skipping`);
+              skipped++;
+              continue;
+            }
+
+            downloadPath = `${downloadDir}/${downloadHistory.torrentName}`;
+            await logger?.info(`Using fallback download path for request ${request.id}: ${downloadPath}`);
+          }
+        } else {
+          // No download client ID - use fallback path
+          if (!downloadHistory.torrentName) {
+            await logger?.warn(`No download client ID or torrent name for request ${request.id}, skipping`);
+            skipped++;
+            continue;
+          }
+
+          const configService = getConfigService();
+          const downloadDir = await configService.get('download_dir');
+
+          if (!downloadDir) {
+            await logger?.error(`download_dir not configured, cannot retry request ${request.id}, skipping`);
+            skipped++;
+            continue;
+          }
+
+          downloadPath = `${downloadDir}/${downloadHistory.torrentName}`;
+          await logger?.info(`Using configured download path for request ${request.id}: ${downloadPath}`);
+        }
 
         await jobQueue.addOrganizeJob(
           request.id,

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

@@ -21,10 +21,11 @@ export async function processRetryMissingTorrents(payload: RetryMissingTorrentsP
   await logger?.info('Starting retry job for requests awaiting search...');
 
   try {
-    // Find all requests in awaiting_search status
+    // Find all active requests in awaiting_search status
     const requests = await prisma.request.findMany({
       where: {
         status: 'awaiting_search',
+        deletedAt: null,
       },
       include: {
         audiobook: true,

src/lib/processors/scan-plex.processor.ts

@@ -140,7 +140,10 @@ export async function processScanPlex(payload: ScanPlexPayload): Promise<any> {
     // 5. Match downloaded requests against library
     await logger?.info(`Checking for downloaded requests to match...`);
     const downloadedRequests = await prisma.request.findMany({
-      where: { status: 'downloaded' },
+      where: {
+        status: 'downloaded',
+        deletedAt: null,
+      },
       include: { audiobook: true },
       take: 50, // Limit to prevent overwhelming
     });