<?php

namespace App\Http\Controllers\Api\Concerns;

use App\Enums\Portal;
use App\Services\CurrentPortalContext;

/**
 * Löst das Ziel-Portal eines API-Schreibzugriffs auf.
 *
 * Reihenfolge (Entscheidung 13.08.2026, API-Portal-Fix):
 * 1. Explizit mitgesendeter portal-Parameter (überstimmt alles).
 * 2. Domain des Requests (CurrentPortalContext, gesetzt via SetCurrentPortal:
 *    presseecho.de → presseecho, businessportal24.de → businessportal24).
 * 3. Aufrufer-spezifischer Fallback (Portal der Firma bzw. des Users) —
 *    greift z. B. bei Calls über die Portal-/Admin-Domain ohne Parameter.
 * 4. `Portal::Both` als letzter Ausweg.
 *
 * Stufe 4 macht die Rückgabe bewusst nicht-nullbar: `press_releases.portal` und
 * `companies.portal` sind NOT-NULL-ENUMs mit genau diesem Default. Ein `null`
 * aus dieser Methode landete also als SQL-Fehler und damit als 500er beim
 * Alt-Client, statt als verwertbare Antwort — und die Aufrufer, die das
 * Ergebnis direkt mit `->value` weiterreichen, wären ein Fatal Error.
 */
trait ResolvesRequestedPortal
{
    private function resolveRequestedPortal(?string $requestedPortal, ?Portal $fallback): Portal
    {
        return Portal::tryFrom((string) $requestedPortal)
            ?? CurrentPortalContext::get()
            ?? $fallback
            ?? Portal::Both;
    }
}