146 Commits

Author	SHA1	Message	Date
gronod	9621aec453	test: add comprehensive test suite for Ombi integration ... - Add tests for Ombi configuration parsing (OMBI_INSTANCES JSON array, legacy fallback) - Add tests for OmbiClient API methods (movie/TV requests, search by TMDB/IMDB/TVDB) - Add tests for OmbiRetriever caching, queue, and search functionality - Add tests for arrRetrieverRegistry initialization and retrieval methods - Add tests for DownloadMatcher.addOmbiMatching integration - Add tests for DownloadAssembler Ombi link generation utilities - Export addOmbiMatching from DownloadMatcher module	2026-05-21 18:43:09 +01:00
gronod	ed4237debb	feat(ombi): Add Ombi PALDRA integration for request management ... - Add OmbiRetriever extending ArrRetriever for PALDRA compliance - Add OmbiClient for low-level Ombi API communication - Add getOmbiInstances() to config.js following multi-instance pattern - Register Ombi in PALDRA registry with Ombi-specific methods - Add external ID matching (TMDB/TVDB/IMDB) to Ombi requests - Update DownloadMatcher to be async and enrich downloads with Ombi links - Add getOmbiLink/getOmbiSearchLink helpers to DownloadAssembler - Implement new service icon layout (Ombi + Sonarr/Radarr icons) - Add CSS styling for service icons - Update dashboard routes to include Ombi configuration - Extend OpenAPI with Ombi tag and NormalizedDownload properties - Update documentation (README, ARCHITECTURE, SECURITY, CHANGELOG) - Add Ombi configuration to .env.sample	2026-05-21 17:00:04 +01:00
gronod	de9a9284dc	fix: replace client-side Swagger server detection with server-side dynamic spec ... - Change swaggerUi.setup to pass null and fetch spec from /api/swagger.json - Update /api/swagger.json handler to dynamically set server URL based on request - Remove dead client-side detection script (swagger-server-detection.js) - Server-side detection respects TRUST_PROXY for reverse proxy scenarios - req.protocol and req.get('host') automatically use X-Forwarded headers when configured - Fixes issue where placeholder URL was never replaced due to window.ui being unavailable	2026-05-21 15:24:28 +01:00
gronod	52a75fd8cb	feat: replace static Swagger UI server selector with dynamic client-side detection ... - Update openapi.yaml to use single placeholder server URL - Add swagger-server-detection.js to auto-detect current server URL from window.location - Configure protocol, host, and port detection based on browser connection - Fallback to placeholder URL if detection fails - Include detection script in both app.js and index.js Swagger UI configurations - /api/swagger.json endpoint returns static placeholder for external consumers	2026-05-21 14:52:04 +01:00
gronod	4941b69924	fix: resolve test failures - add missing emby route and fix YAML syntax errors ... - Add GET /api/emby/users/:id endpoint to fetch individual user by ID - Fix YAML semantic errors in dashboard.js and history.js by quoting parameter descriptions with colons - Add x-integration-notes to /api/dashboard/stream endpoint description - All 644 tests now passing	2026-05-21 14:34:45 +01:00
gronod	1a4ff73067	feat(ci): add RAML 1.0 package generation pipeline ... - Add generate:openapi, generate:raml, package:raml scripts to package.json - Add archiver dependency for creating tar.gz archives - Create scripts/generate-openapi.js to fetch merged OpenAPI spec from running server - Create scripts/package-raml.js to build versioned RAML tar.gz archive - Create .spectral.yml with minimal OpenAPI linting rules - Add /api/swagger.json endpoint to server/app.js for serving merged spec - Extend swagger job in ci.yml with RAML generation steps - Upload raml-package artifact to CI with 14-day retention	2026-05-21 14:04:26 +01:00
gronod	a141bb57d6	docs(swagger): add JSDoc @openapi for public health endpoints ... - GET /health: returns uptime, no auth/rate-limit - GET /ready: checks EMBY_URL configuration, returns 503 if not ready - Document Docker HEALTHCHECK usage	2026-05-21 12:38:02 +01:00
gronod	43f5a52749	docs(swagger): add JSDoc @openapi for proxy routes ... - Sonarr: queue, history, series, notifications CRUD, webhook setup - Radarr: queue, history, movies, notifications CRUD, webhook setup - SABnzbd: queue, history - Emby: sessions, users - Document that these are authenticated proxies to upstream services - Include notification proxy endpoints for webhook configuration	2026-05-21 12:37:36 +01:00
gronod	5c0ad7cb1b	docs(swagger): add JSDoc @openapi for webhook endpoints ... - POST /api/webhook/sonarr: secret validation, rate-limited, replay protection - POST /api/webhook/radarr: identical processing logic - Document X-Sofarr-Webhook-Secret header requirement - List all valid eventType values - Document event classification (QUEUE vs HISTORY) - Include replay protection window (5 minutes)	2026-05-21 12:36:43 +01:00
gronod	a21bafa041	docs(swagger): add JSDoc @openapi for status and history endpoints ... - GET /api/status/status: admin-only, server/cache/polling/webhook metrics - GET /api/history/recent: filtered by user tag, deduplication logic - Document deduplication rules (imported suppresses failed) - Document availableForUpgrade flag - Include query parameters (days, showAll)	2026-05-21 12:36:07 +01:00
gronod	12effe17d3	docs(swagger): add JSDoc @openapi for dashboard endpoints ... - GET /api/dashboard/user-downloads: deprecated, use SSE - GET /api/dashboard/cover-art: image proxy for CSP compliance - GET /api/dashboard/stream: SSE real-time updates, no CSRF needed - POST /api/dashboard/blocklist-search: admin-only, removes + re-searches - Document SSE event format and heartbeat - Include admin-only constraints and error responses	2026-05-21 12:32:29 +01:00
gronod	1bb9e4014e	docs(swagger): add JSDoc @openapi for auth endpoints ... - POST /api/auth/login: rate-limited, sets httpOnly cookie, issues CSRF token - GET /api/auth/me: returns current authenticated user - GET /api/auth/csrf: refreshes CSRF token - POST /api/auth/logout: clears cookies, revokes Emby token - Include x-code-samples (curl, JS fetch, TypeScript) - Include x-integration-notes for cookie flow - Full JSON Schema with realistic examples	2026-05-21 12:31:41 +01:00
gronod	964dacc588	feat(swagger): mount Swagger UI at /api/swagger ... - Import swagger-ui-express, swagger-jsdoc, yamljs in app.js and index.js - Load server/openapi.yaml as base spec - Configure swagger-jsdoc to merge JSDoc comments from route files - Mount Swagger UI at /api/swagger (publicly accessible) - Add authentication banner explaining cookie + CSRF flow - Ensure spec loads from both createApp (tests) and index.js (production)	2026-05-21 12:30:53 +01:00
gronod	777fa26e5b	feat(swagger): add central OpenAPI 3.1 specification file ... - Create server/openapi.yaml with OpenAPI 3.1.0 base - Define info, servers, tags, securitySchemes - Add component schemas: NormalizedDownload, DashboardPayload, ErrorResponse, BlocklistSearchRequest, WebhookPayload, HistoryItem, StatusResponse - Add path placeholders for all endpoints (to be merged with JSDoc) - Document cookie-based auth + CSRF security scheme	2026-05-21 12:30:01 +01:00
gronod	251c10f08c	Add logging to blocklist-search endpoint for debugging ... - Log missing required fields to help diagnose blocklist issues - Shows which fields are present/absent in the request body	2026-05-21 02:11:45 +01:00
gronod	474ae949a9	Fix progress calculation to support both mbleft and mbmissing fields ... - SABnzbd API uses different field names for remaining bytes - Test data uses mbmissing, but real API may use mbleft - Support both field names to handle all cases - Fixes DownloadBuilder test failures	2026-05-21 02:07:54 +01:00
gronod	084cb0579e	Fix missing progress bar for SABnzbd downloads ... - Calculate progress from slot.mb and slot.mbleft instead of slot.percentage - Apply fix to both series and movie downloads in matchSabSlots - Add progress: 100 for history items in matchSabHistory (series and movie) - SABnzbd slot data doesn't have percentage field, so progress was undefined	2026-05-21 01:55:03 +01:00
gronod	93a09e10a8	Fix background fetch to not overwrite cache with empty data ... - Only trigger background refresh if cache is incomplete (less than max records) - Only update cache if background fetch returns records (don't overwrite on failure) - Prevents test failures when background fetch fails to connect to Sonarr/Radarr - Fixes integration test 'includes imported and failed records, excludes grabbed'	2026-05-21 01:53:19 +01:00
gronod	a349c8e2cf	Fix status route path to avoid 404 ... - Change route from '/status' to '/' since router is mounted at '/api/status' - Fixes HTML 404 response when client calls /api/status	2026-05-21 01:41:24 +01:00
gronod	14b47ce410	Fix history pagination and status panel issues ... - Fix history pagination: use retriever's built-in maxPages parameter instead of broken date-based cursor - Fix status panel: correct API endpoint from /api/dashboard/status to /api/status - Background fetch now properly fetches up to 1000 records (10 pages * 100 records) - Status panel will now display details instead of 'Loading Status...'	2026-05-21 01:34:54 +01:00
gronod	0acd452ebd	Implement staged history loading with SSE push ... - Stage 1: Fetch 100 records immediately for fast display - Stage 2+: Background fetch up to 1000 records in batches of 100 - Date-based cursor pagination to avoid race conditions - Deduplication by record ID to prevent duplicates - SSE push to clients when history cache is updated - Shared background fetch state for concurrent user requests	2026-05-21 01:23:11 +01:00
gronod	b9b5d7d393	Increase history pageSize from 100 to 500 to fetch more records ... Fixes issue where series beyond position 100 in history were not appearing in recently completed section.	2026-05-21 01:10:36 +01:00
gronod	7424e70ea6	Add logging for total Sonarr/Radarr records fetched	2026-05-21 01:06:28 +01:00
gronod	830dea3d6b	Add logging for filtered event types and missing series/movie objects	2026-05-21 01:02:57 +01:00
gronod	4ff462b7f4	Add detailed logging for all series/movies with raw tag IDs to debug missing items	2026-05-21 01:01:14 +01:00
gronod	d9f1fc99a9	Add debugging logs for history filtering to diagnose missing series	2026-05-21 00:58:10 +01:00
gronod	3c9dd3ca62	Fix: Remove unmatched torrents from download display ... Downloads with no match in Sonarr or Radarr were being displayed when they should not be. Removed the code in matchTorrents that was adding unmatched torrents to results.	2026-05-21 00:37:37 +01:00
gronod	d9897ff0d2	Extract matching logic into new DownloadMatcher service	2026-05-21 00:04:57 +01:00
gronod	06442c1d75	Add JSDoc comments and defensive error handling to DownloadBuilder.js	2026-05-21 00:00:46 +01:00
gronod	a38fc4a8ce	refactor: extract status route and WebhookStatus service, slim dashboard.js ... - Extract /status route to server/routes/status.js - Create server/services/WebhookStatus.js with checkWebhookConfigured and aggregateMetrics - Slim dashboard.js to pure HTTP orchestration (559→283 lines, 49.4% reduction) - Remove /user-summary and /webhook-metrics routes from dashboard.js - Mount status router at /api/status in server/index.js and server/app.js - Update tests to use new /api/status/status endpoint - Fix test expectation for speed field (number vs string) All 571 tests passing.	2026-05-20 22:50:40 +01:00
gronod	2bf4cb2a0f	Refactor: Deduplicate download assembly logic into DownloadBuilder service ... - Created server/services/DownloadBuilder.js with buildUserDownloads function - Added private helpers: buildSeriesMapFromRecords, buildMoviesMapFromRecords, matchSabSlots, matchSabHistory, matchTorrents, getSlotStatusAndSpeed - Updated server/routes/dashboard.js to use buildUserDownloads in /user-downloads and SSE /stream - Removed ~500 lines of duplicated download-assembly logic - All unit tests passing (DownloadBuilder: 14, DownloadAssembler: 73, TagMatcher: 26)	2026-05-20 22:43:03 +01:00
gronod	9cffb96f29	Extract DownloadAssembler service from dashboard routes ... - Create server/services/DownloadAssembler.js with 7 pure functions: - getCoverArt, getImportIssues, getSonarrLink, getRadarrLink - canBlocklist, extractEpisode, gatherEpisodes - Update server/routes/dashboard.js to use DownloadAssembler - Add comprehensive unit tests (73 tests covering edge cases) - Fix null check in extractEpisode function - All tests passing: DownloadAssembler (73/73), TagMatcher (26/26)	2026-05-20 22:32:09 +01:00
gronod	4d61dd566f	Refactor: Extract tag functions to TagMatcher service ... - Extract six pure tag-related functions from dashboard.js into new server/services/TagMatcher.js - Functions: sanitizeTagLabel, tagMatchesUser, extractAllTags, extractUserTag, getEmbyUsers, buildTagBadges - Update dashboard.js to import TagMatcher and replace all inline function calls - Add comprehensive unit tests in tests/unit/services/TagMatcher.test.js (26 tests passing for 5 pure functions) - Note: getEmbyUsers tests excluded due to CommonJS mocking complexity	2026-05-20 22:21:01 +01:00
gronod	d568800942	fix: limit history pagination to prevent 40s response times ... The full pagination fix (ddad80a, e772001) caused history retrieval to fetch up to 50 pages sequentially, taking 10-40 seconds instead of ~200ms. Changes: - Add maxPages parameter to getHistory() with default of 1 page - Update poller to fetch 50 records (up from 10) in a single API call - historyFetcher retains 100 records per page for UI display This provides 5x more history for matching than before while keeping the fast single-request performance. Refs: develop-merge pagination performance issue	2026-05-20 21:44:53 +01:00
Gandalf	ee2f275501	Merge pull request 'fix: use stable *arr IDs for matching before fragile title fallback' (#21) from fix-arr-matching into develop-merge ... Reviewed-on: #21	2026-05-20 21:02:10 +01:00
Gandalf	ca6ff66115	Merge pull request 'fix: webhook replay cache atomicity and instanceName precision' (#22) from fix-webhook-receiver into develop-merge ... Reviewed-on: #22	2026-05-20 21:01:52 +01:00
Gandalf	080431c4b7	Merge pull request 'fix: QBittorrent fallback state corruption after full sync' (#23) from fix-qbittorrent-client into develop-merge ... Reviewed-on: #23	2026-05-20 21:01:36 +01:00
Gandalf	f457a708d2	Merge pull request 'fix: SABnzbd speed assignment and size/progress parsing' (#24) from fix-sabnzbd-client into develop-merge ... Reviewed-on: #24	2026-05-20 21:01:21 +01:00
Gandalf	914ab73d4e	Merge pull request 'fix: full pagination + non-silent errors in PollingRadarrRetriever' (#25) from fix-radarr-retriever into develop-merge ... Reviewed-on: #25	2026-05-20 21:01:07 +01:00
gronod	bb7b66e06d	fix: use stable *arr IDs for matching before fragile title fallback	2026-05-20 20:51:50 +01:00
gronod	5ad525a760	fix: webhook replay cache atomicity and instanceName precision	2026-05-20 20:46:35 +01:00
gronod	1e162381f4	fix: QBittorrent fallback state corruption after full sync	2026-05-20 20:45:26 +01:00
gronod	42f0481a9a	fix: SABnzbd speed assignment and size/progress parsing	2026-05-20 20:44:08 +01:00
gronod	ddad80a666	fix: full pagination + non-silent errors in PollingRadarrRetriever	2026-05-20 20:42:18 +01:00
gronod	e772001c3f	fix: full pagination + non-silent errors in PollingSonarrRetriever	2026-05-20 20:40:48 +01:00
gronod	a562cfe9aa	Add logging to debug active download identification and speed	2026-05-20 01:00:25 +01:00
gronod	8549746721	Apply overall SABnzbd speed to active download only	2026-05-20 00:58:38 +01:00
gronod	63fc370262	Remove speed from SABnzbd downloads - API doesn't provide per-download speed	2026-05-20 00:56:54 +01:00
gronod	6362441dd5	Add logging to debug SABnzbd speed field in slot data	2026-05-20 00:54:26 +01:00
gronod	76f9e87b44	Add logging to investigate SABnzbd slot structure for speed field	2026-05-20 00:51:12 +01:00