Add release blocklist feature

Introduce a per-request release blocklist to auto-block permanently failing releases and provide admin management. Changes include:

- Database: add BlockedRelease model (blocked_releases) to Prisma schema with unique (requestId, releaseKey) and indexes; documented in backend database docs.
- Service & utils: new blocklist.service, release-key and filter helpers for normalization and matching; processors updated to emit auto-blocks (monitor-download, organize-files, search processors, RSS).
- HTTP API: add admin endpoints GET/DELETE /api/admin/blocklist, DELETE /api/admin/blocklist/[id], and GET /api/admin/blocklist/by-request/[requestId].
- Admin UI: new /admin/blocklist page and numerous React components (toolbar, filters, table, rows, pagination, skeleton, chips, date picker) with URL-driven state hook and per-row unblock UX.
- Tests: add unit/integration tests for service, routes, utils, and updated processor tests.

The blocklist is idempotent (upsert), filters search results before ranking (interactive search shows badges only), and admin-only APIs require auth. This commit wires docs, API, DB, frontend and tests for the new feature.
This commit is contained in:
kikootwo
2026-05-18 12:15:51 -04:00
parent fb0445d95f
commit b1492fc32e
41 changed files with 4098 additions and 12 deletions
@@ -35,6 +35,8 @@ function futureDate(days = 30): Date {
describe('processMonitorRssFeeds', () => {
beforeEach(() => {
vi.clearAllMocks();
// Default to empty blocklist so the filter is a no-op unless a test overrides.
prismaMock.blockedRelease.findMany.mockResolvedValue([]);
});
it('matches RSS items and queues search jobs', async () => {
@@ -108,6 +110,42 @@ describe('processMonitorRssFeeds', () => {
expect(prismaMock.request.update).not.toHaveBeenCalled();
});
it('does not queue a search when the matching RSS release is on the request blocklist', async () => {
configMock.get.mockImplementation(async (key: string) => {
if (key === 'prowlarr_indexers') {
return JSON.stringify([{ id: 1, name: 'Indexer', rssEnabled: true }]);
}
if (key === 'indexer.skip_unreleased') return null;
return null;
});
prowlarrMock.getAllRssFeeds.mockResolvedValue([
{ title: 'Great Book - Author Name' },
]);
prismaMock.request.findMany.mockResolvedValue([
{
id: 'req-blocked',
type: 'audiobook',
status: 'awaiting_search',
releaseDate: null,
audiobook: { id: 'a1', title: 'Great Book', author: 'Author Name', audibleAsin: 'ASIN1' },
},
]);
// The RSS torrent's normalized name is on the request's blocklist.
prismaMock.blockedRelease.findMany.mockResolvedValue([
{ id: 'b1', releaseKey: 'great book - author name', releaseHash: null },
]);
const { processMonitorRssFeeds } = await import('@/lib/processors/monitor-rss-feeds.processor');
const result = await processMonitorRssFeeds({ jobId: 'job-rss-blocked' });
expect(result.success).toBe(true);
expect(jobQueueMock.addSearchJob).not.toHaveBeenCalled();
expect(jobQueueMock.addSearchEbookJob).not.toHaveBeenCalled();
});
it('runs RSS search when matched book is unreleased but setting is OFF', async () => {
configMock.get.mockImplementation(async (key: string) => {
if (key === 'prowlarr_indexers') {