Use metadata registry for web_server clients

- make web_server.py read and refresh Spotify from core.metadata.registry
- add single-key metadata cache eviction for Spotify reauth
- export the new cache helper through the metadata package shims

core/metadata/__init__.py

@@ -22,6 +22,7 @@ from core.metadata.discography import (
 from core.metadata.lookup import MetadataLookupOptions
 from core.metadata.registry import (
     METADATA_SOURCE_PRIORITY,
+    clear_cached_metadata_client,
     clear_cached_metadata_clients,
     get_client_for_source,
     get_deezer_client,
@@ -51,6 +52,7 @@ __all__ = [
     "check_album_completion",
     "check_artist_discography_completion",
     "check_single_completion",
+    "clear_cached_metadata_client",
     "clear_cached_metadata_clients",
     "get_album_for_source",
     "get_album_tracks_for_source",

core/metadata/registry.py

@@ -65,6 +65,12 @@ def clear_cached_metadata_clients() -> None:
         _client_cache.clear()
 
 
+def clear_cached_metadata_client(cache_key: str) -> None:
+    """Clear one lazily-created client singleton by cache key."""
+    with _client_cache_lock:
+        _client_cache.pop(cache_key, None)
+
+
 def _get_config_value(key: str, default: Any = None) -> Any:
     try:
         from config.settings import config_manager

core/metadata_service.py

@@ -39,6 +39,7 @@ from core.metadata.discography import (
 from core.metadata.lookup import MetadataLookupOptions
 from core.metadata.registry import (
     METADATA_SOURCE_PRIORITY,
+    clear_cached_metadata_client,
     clear_cached_metadata_clients,
     get_client_for_source,
     get_deezer_client,
@@ -89,6 +90,7 @@ __all__ = [
     "check_album_completion",
     "check_artist_discography_completion",
     "check_single_completion",
+    "clear_cached_metadata_client",
     "clear_cached_metadata_clients",
     "get_album_for_source",
     "get_album_tracks_for_source",

web_server.py

@@ -97,7 +97,11 @@ from core.matching_engine import MusicMatchingEngine
 from core.database_update_worker import DatabaseUpdateWorker
 from core.web_scan_manager import WebScanManager
 from core.metadata.cache import get_metadata_cache
-from core.metadata.registry import register_runtime_clients as register_metadata_runtime_clients
+from core.metadata.registry import (
+    clear_cached_metadata_client,
+    get_spotify_client,
+    register_runtime_clients,
+)
 from core.imports.context import (
     get_import_clean_album,
     get_import_clean_title,
@@ -611,8 +615,8 @@ logger.info("Initializing SoulSync services for Web UI...")
 spotify_client = plex_client = jellyfin_client = navidrome_client = soulsync_library_client = soulseek_client = tidal_client = matching_engine = sync_service = web_scan_manager = None
 
 try:
-    spotify_client = SpotifyClient()
+    spotify_client = get_spotify_client()
-    logger.info("  Spotify client initialized")
+    logger.info("  Spotify client initialized via metadata registry")
 except Exception as e:
     logger.error(f"  Spotify client failed to initialize: {e}")
 
@@ -7291,7 +7295,7 @@ def auth_spotify():
                 logger.error(f"Per-profile Spotify auth failed, falling back to global: {e}")
 
         # Global auth (admin or fallback)
-        temp_spotify_client = SpotifyClient()
+        temp_spotify_client = get_spotify_client()
         if temp_spotify_client.sp and temp_spotify_client.sp.auth_manager:
             # Get the authorization URL
             auth_url = temp_spotify_client.sp.auth_manager.get_authorize_url()
@@ -7640,7 +7644,8 @@ def spotify_callback():
         if token_info:
             # CRITICAL: update the GLOBAL spotify_client, not a local variable
             global spotify_client
-            spotify_client = SpotifyClient()
+            clear_cached_metadata_client("spotify")
+            spotify_client = get_spotify_client()
             if spotify_client.is_spotify_authenticated():
                 # Clear any active rate limit ban and post-ban cooldown
                 # so Spotify is immediately usable after re-auth
@@ -38617,7 +38622,6 @@ def start_oauth_callback_servers():
 
                     # Manually trigger the token exchange using spotipy's auth manager
                     try:
-                        from core.spotify_client import SpotifyClient
                         from spotipy.oauth2 import SpotifyOAuth
                         from config.settings import config_manager
 
@@ -38641,7 +38645,8 @@ def start_oauth_callback_servers():
                         if token_info:
                             # Reinitialize the global client with new tokens
                             global spotify_client
-                            spotify_client = SpotifyClient()
+                            clear_cached_metadata_client("spotify")
+                            spotify_client = get_spotify_client()
 
                             if spotify_client.is_spotify_authenticated():
                                 # Clear rate limit ban + post-ban cooldown so Spotify is usable immediately
@@ -39696,8 +39701,7 @@ except Exception as e:
     hydrabase_worker = None
     hydrabase_client = None
 
-register_metadata_runtime_clients(
+register_runtime_clients(
-    spotify_client=spotify_client,
     hydrabase_client=hydrabase_client,
     dev_mode_enabled_provider=lambda: dev_mode_enabled,
 )