presseportale/app/Services/Api/ApiAccessEligibilityService.php

<?php

namespace App\Services\Api;

use App\Models\User;

/**
 * API-Gate des hybriden Rechnungsmodells: freigeschaltet ist, wer ein
 * aktives Stripe-Abo (Cashier, STR-Kreis), eine laufende Zahlungsoption
 * (MAN-Kreis/Bestandsschutz) oder eine bezahlte letzte Legacy-Rechnung hat —
 * spiegelbildlich zu User::hasActiveBooking(). Geprüft beim Erzeugen eines
 * Tokens und bei jedem API-Aufruf.
 */
class ApiAccessEligibilityService
{
    public function canCreateToken(User $user): bool
    {
        return $this->hasApiAccess($user);
    }

    /**
     * Gilt beim Erzeugen eines Tokens und bei jedem API-Aufruf
     * (EnsureApiAccessIsBooked).
     */
    public function hasApiAccess(User $user): bool
    {
        return $this->denialReason($user) === null;
    }

    public function denialReason(User $user): ?string
    {
        if (! $user->is_active) {
            return 'Ihr Benutzerkonto ist nicht aktiv. API-Tokens können nur für aktive Benutzer erstellt werden.';
        }

        if ($user->subscribed() || $user->hasActivePaymentOption() || $this->hasPaidLegacyInvoice($user)) {
            return null;
        }

        return 'API-Tokens werden erst freigeschaltet, wenn ein aktives Abo, ein aktiver Zahlungsstatus oder freigegebener Bestandsschutz vorliegt.';
    }

    /**
     * Legacy-Pfad für Altkunden ohne Zahlungsoption: die zuletzt gestellte
     * Legacy-Rechnung muss bezahlt sein.
     */
    private function hasPaidLegacyInvoice(User $user): bool
    {
        return $user->latestLegacyInvoice()?->status === 'paid';
    }
}