Add DB pooling, throttling and monitor backoff

Add connection pool params to DATABASE_URL and configure Prisma to use the pooled URL (connection_limit=20, pool_timeout=30) to reduce connection exhaustion. Introduce safeguards and throttling across processors: limit in-flight progress DB updates in direct-download, add short delays when processing RSS, retry-failed-imports, and retry-missing-torrents, and stagger scheduler triggers to avoid bursts. Implement adaptive monitor-download polling with stallCount/lastProgress and exponential backoff, and thread these fields through JobQueueService (including reduced worker concurrency for several queues). Batch audiobook enrichment queries to small parallel batches to limit DB load. Update tests to reflect new monitor payload parameters. Overall intent: reduce DB connection pool pressure and smooth load spikes during startup and heavy processing.

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

@@ -316,6 +316,7 @@ async function downloadFileWithProgress(
     let bytesDownloaded = 0;
     let lastLogTime = Date.now();
     let lastDbUpdateTime = Date.now();
+    let dbUpdatePending = false; // Guard against stacking unresolved DB updates
 
     response.data.on('data', (chunk: Buffer) => {
       bytesDownloaded += chunk.length;
@@ -332,18 +333,18 @@ async function downloadFileWithProgress(
         logger.info(`Download progress: ${percent}% (${(bytesDownloaded / (1024 * 1024)).toFixed(1)} MB, ${speedMBps.toFixed(2)} MB/s)`);
         lastLogTime = now;
 
-        // Update database with progress (non-blocking)
-        if (now - lastDbUpdateTime >= PROGRESS_UPDATE_INTERVAL_MS) {
+        // Update database with progress (non-blocking, at most 1 in-flight at a time)
+        if (now - lastDbUpdateTime >= PROGRESS_UPDATE_INTERVAL_MS && !dbUpdatePending) {
           lastDbUpdateTime = now;
+          dbUpdatePending = true;
 
-          // Non-blocking update - fire and forget
           prisma.request.update({
             where: { id: tracking.requestId },
             data: {
               progress: Math.min(percent, 99), // Cap at 99% until fully complete
               updatedAt: new Date(),
             },
-          }).catch(() => {}); // Ignore errors during progress update
+          }).catch(() => {}).finally(() => { dbUpdatePending = false; });
         }
       }
     });

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

@@ -16,8 +16,23 @@ import { CLIENT_PROTOCOL_MAP, DownloadClientType } from '../interfaces/download-
  * Checks download progress from download client and updates request status
  * Re-schedules itself if download is still in progress
  */
+/** Base polling interval in seconds */
+const BASE_POLL_INTERVAL = 10;
+/** Maximum polling interval in seconds (5 minutes) */
+const MAX_POLL_INTERVAL = 300;
+
+/**
+ * Compute next poll delay with exponential backoff for stalled downloads.
+ * Active downloads poll every 10s; stalled downloads back off up to 5 min.
+ */
+function getBackoffDelay(stallCount: number): number {
+  if (stallCount <= 0) return BASE_POLL_INTERVAL;
+  return Math.min(BASE_POLL_INTERVAL * Math.pow(2, stallCount), MAX_POLL_INTERVAL);
+}
+
 export async function processMonitorDownload(payload: MonitorDownloadPayload): Promise<any> {
-  const { requestId, downloadHistoryId, downloadClientId, downloadClient, jobId } = payload;
+  const { requestId, downloadHistoryId, downloadClientId, downloadClient, jobId,
+          lastProgress: prevProgress, stallCount: prevStallCount } = payload;
 
   const logger = RMABLogger.forJob(jobId, 'MonitorDownload');
 
@@ -199,22 +214,35 @@ export async function processMonitorDownload(payload: MonitorDownloadPayload): P
         progress: progressPercent,
       };
     } else {
-      // Still downloading - schedule another check in 10 seconds
+      // Still downloading — compute adaptive poll interval
+      const isStalled = info.downloadSpeed === 0
+        || progressPercent === (prevProgress ?? -1)
+        || progressState === 'paused'
+        || progressState === 'queued'
+        || progressState === 'checking';
+
+      const stallCount = isStalled ? (prevStallCount ?? 0) + 1 : 0;
+      const delay = getBackoffDelay(stallCount);
+
       const jobQueue = getJobQueueService();
       await jobQueue.addMonitorJob(
         requestId,
         downloadHistoryId,
         downloadClientId,
         downloadClient,
-        10 // Delay 10 seconds between checks
+        delay,
+        progressPercent,
+        stallCount
       );
 
-      // Only log every 5% progress to reduce log spam
-      const shouldLog = progressPercent % 5 === 0 || progressPercent < 5;
+      // Only log every 5% progress to reduce log spam, but always log stall transitions
+      const shouldLog = progressPercent % 5 === 0 || progressPercent < 5
+        || (stallCount === 1) || (stallCount > 0 && stallCount % 10 === 0);
       if (shouldLog) {
         logger.info(`Request ${requestId}: ${progressPercent}% complete (${progressState})`, {
           speed: info.downloadSpeed,
           eta: info.eta,
+          ...(stallCount > 0 && { stallCount, nextPollSec: delay }),
         });
       }
 
@@ -227,6 +255,8 @@ export async function processMonitorDownload(payload: MonitorDownloadPayload): P
         speed: info.downloadSpeed,
         eta: info.eta,
         state: progressState,
+        stallCount,
+        nextPollSec: delay,
       };
     }
   } catch (error) {

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

@@ -124,6 +124,9 @@ export async function processMonitorRssFeeds(payload: MonitorRssFeedsPayload): P
         break;
       }
     }
+
+    // Spread DB operations over time to avoid connection pool exhaustion
+    await new Promise(resolve => setTimeout(resolve, 100));
   }
 
   logger.info(`RSS monitoring complete: ${matched} matches found and queued for processing`);

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

@@ -157,6 +157,9 @@ export async function processRetryFailedImports(payload: RetryFailedImportsPaylo
         );
         triggered++;
         logger.info(`Triggered organize job for ${request.type || 'audiobook'} request ${request.id}: ${request.audiobook.title}`);
+
+        // Spread DB operations over time to avoid connection pool exhaustion
+        await new Promise(resolve => setTimeout(resolve, 100));
       } catch (error) {
         logger.error(`Failed to trigger organize for request ${request.id}: ${error instanceof Error ? error.message : 'Unknown error'}`);
         skipped++;

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

@@ -44,6 +44,7 @@ export async function processRetryMissingTorrents(payload: RetryMissingTorrentsP
     }
 
     // Trigger appropriate search job for each request based on type
+    // Throttle: 100ms delay between jobs to avoid connection pool burst
     const jobQueue = getJobQueueService();
     let triggered = 0;
 
@@ -73,6 +74,9 @@ export async function processRetryMissingTorrents(payload: RetryMissingTorrentsP
       } catch (error) {
         logger.error(`Failed to trigger search for request ${request.id}: ${error instanceof Error ? error.message : 'Unknown error'}`);
       }
+
+      // Spread DB operations over time to avoid connection pool exhaustion
+      await new Promise(resolve => setTimeout(resolve, 100));
     }
 
     logger.info(`Triggered ${triggered}/${requests.length} search jobs`);