Add ScreenScraper metadata proxy support via Hasheous

[gantoine]

TL;DR
Adds ScreenScraper metadata fetching through the Hasheous proxy as a credential-free fallback when users don't have their own ScreenScraper account. This leverages new Hasheous endpoints for game metadata lookups by hash or game ID.

What changed?

• Hasheous Handler Enhancement: Added get_ss_game() and get_ss_rom_by_id() methods to fetch ScreenScraper metadata through the Hasheous proxy endpoint (/MetadataProxy/ScreenScraper/jeuInfos.php)

  • get_ss_game() performs hash-based lookups (MD5, SHA1, CRC) with file size and name as fallbacks
  • get_ss_rom_by_id() refetches metadata by existing game ID
  • Both methods reuse existing ScreenScraper parsing logic via build_ss_game() to maintain consistent metadata structure

• Scan Handler Integration: Updated ROM scanning logic to fall back to Hasheous ScreenScraper proxy when:

  • ScreenScraper direct access is disabled (meta_ss_handler not enabled)
  • Hasheous is enabled and the platform is in the supported list
  • Prioritizes direct ScreenScraper if available, falls back to Hasheous proxy otherwise

• File Filtering: Implemented platform-specific file extension filtering for hash-based lookups, selecting the largest valid file as most likely to contain the main ROM

• Test Coverage: Added comprehensive unit tests for the Hasheous ScreenScraper proxy functionality

Checklist

• I've tested the changes locally
• I've updated relevant comments
• I've assigned reviewers for this PR
• I've added unit tests that cover the changes

---

Created with PostHog Code