feat(api): production-ready P0/P1 — secrets hors navigateur, clés d'API, métriques

P0
- Aucun secret servi au navigateur : /assets/config.local.js est généré par le
  serveur AVANT les montages statiques (il l'emporte sur le fichier local) et
  ne contient plus YOUTUBE_API_KEY(S) ; le fichier local n'est plus copié dans
  l'image Docker ni embarqué dans dist (angular ignore config.local.js) ;
  youtube-api.service n'appelle plus googleapis directement (fetchYouTube =
  /api/yt -> /proxy/api/yt), gardes « pas de clé => écran vide », rotation et
  carte de bans côté client supprimées ; readiness YouTube via /healthz
  (youtube.keys.count) ; messages d'erreur orientés configuration serveur.
- CORS : origines pilotées par API_ALLOWED_ORIGINS (CSV), méthode PATCH
  ajoutée (requis par /user/preferences), header X-API-Key accepté.
- Clés d'API longue durée : table api_keys (empreinte SHA-256 + préfixe
  affichable), routes GET/POST /api/keys et DELETE /api/keys/:id, jeton
  ntk_… affiché une seule fois, last_used_at à chaque usage ; X-API-Key
  accepté par authMiddleware ET authMiddlewareCookieAware.

P1
- X-Request-Id renvoyé sur chaque réponse + journal JSON structuré en prod
  (ts, reqId, method, route, status, ms).
- GET /metrics : exposition Prometheus sans dépendance (http_requests_total
  par route/code, somme+nombre de durées, uptime/mémoire ; METRICS_TOKEN
  verrouille l'accès si défini).
- Rate-limit sur /api/details (DETAILS_RATE_LIMIT, 60/min, réponse JSON) —
  /transcript avait déjà le sien.
- Version unique package.json : menu du compte, info.version de l'OpenAPI
  (+ schéma apiKeyAuth et chemins /keys / /metrics documentés).

Tests : api_coverage +7 cas « production-ready » (sentinel de fuite de clé,
X-Request-Id, /metrics, CORS PATCH, contrat/version, cycle complet des clés
d'API), suggest, transcript, flags, filters, kind — verts. Build OK.
Vérifs instance locale : config servie sans secret, /api/yt 200 avec la clé
serveur, /metrics alimenté, menu 1.0.59 et 40 cartes rendues sans clé côté
client.

docker-compose/.env.example

@@ -13,6 +13,15 @@ TWITCH_CLIENT_ID=votre_client_id_twitch_ici
 TWITCH_CLIENT_SECRET=votre_client_secret_twitch_ici
 # TWITCH_REDIRECT_URI=http://localhost:4200/api/oauth/twitch/callback
 
+# --- API ouverte aux clients tiers (P0/P1 production-ready) ---
+# Origines autorisées en CORS (CSV) : ajouter l'URL publique de l'app pour des
+# clients navigateur tiers ; les clients curl/script ne sont pas concernés.
+# API_ALLOWED_ORIGINS=http://localhost:4200,http://localhost:4000,http://localhost:3000
+# Si défini, /metrics exige Authorization: Bearer <valeur> (ou ?token=)
+# METRICS_TOKEN=
+# Appels /api/details par minute (yt-dlp, défaut 60)
+# DETAILS_RATE_LIMIT=60
+
 # Google OAuth (import abonnements + favoris YouTube, lecture seule)
 # GOOGLE_CLIENT_ID=votre_client_id_google_ici
 # GOOGLE_CLIENT_SECRET=votre_client_secret_google_ici