v1.0.9-beta.057 - feat/fix/test: implement debug logging, resolve issue extraction, and fix scanner tests
This major update introduces a dedicated debug logging tier for advanced administrative troubleshooting, resolves a critical file parsing collision in the Match Series router, and updates the unit test suite to support recent scanner additions.
✨ Features & Enhancements
- Toggleable Debug Engine: Upgraded the core Logger engine to support a dynamic debug mode that can be toggled on the fly via the Admin System Logs UI. This allows administrators to safely trace exact variable states, API payloads, and physical path evaluations without restarting the server or overwhelming the standard console output. Standard info, warn, and error logs remain untouched during standard operation.
🐛 Bug Fixes & Parser Upgrades
- Priority Waterfall Extraction: Replaced the flawed single-pass regular expression in the Match Series router with a priority-based waterfall method. This prevents the scanner from falling into a left-to-right trap where it falsely identifies Volume markers (e.g., V2023) as the primary issue number, effectively resolving file overwrite collisions and improper renaming.
🧪 Testing & Maintenance
- LibraryScanner Mocks: Resolved a TypeError in the test suite caused by the newly introduced Ghost Issue Sweeper. Added prisma.issue.findMany, prisma.issue.update, prisma.issue.delete, and prisma.readProgress.deleteMany to the Vitest hoisted mocks with default empty return values, ensuring the test runner safely executes cleanup logic without crashing.
🛠️ Deep Debug Tracing
Injected highly detailed debug traces across critical backend pathways to aid in future troubleshooting:
- File Operations & Parsing: Importer routing logic, Priority Waterfall regex rule triggers, batch payload detection, unmatched issue linking collisions, generated OS-level file paths, overwrite prevention aborts, and bulk renaming string replacements.
- Metadata & Automation: Raw XML tag dumping from embedded ComicInfo.xml archives, ComicVine/Metron API polling rates, series.json generation, and search engine fuzzy matching/acronym expansion.
- Network & Hosters: Download client payload delivery (qBittorrent/SABnzbd/etc.), GetComics deep-link decoding, Mega folder decryption, and FlareSolverr 403 bypasses.
- Background Jobs: Native library scanner disk traversal, BullMQ job execution (Watch folder sync, Series monitor), and System Health Checker disk/rate-limit evaluations.
- Auth & External APIs: OIDC Single Sign-On group mapping, 3rd party OPDS API key validation, Discord webhook payload construction, and raw OPDS page streaming.