mivita/app/Services/Payment/Stripe/StripeClientWrapper.php

<?php

namespace App\Services\Payment\Stripe;

use Stripe\StripeClient;

/**
 * Dünne, injizierbare Hülle um den Stripe-SDK-Client.
 *
 * Hier sitzt der bewusst aus config/stripe.php verlagerte Hard-Fail
 * (Plan S0.4-Abweichung): Ein Deployment ohne Stripe-Keys bootet normal
 * (Dark Launch); erst die tatsächliche Nutzung ohne STRIPE_SECRET
 * schlägt hart und diagnostizierbar fehl.
 */
class StripeClientWrapper
{
    private ?StripeClient $client = null;

    public function __construct(private readonly ?string $secret) {}

    public function client(): StripeClient
    {
        if ($this->client === null) {
            if ($this->secret === null || trim($this->secret) === '') {
                throw new \RuntimeException(
                    'STRIPE_SECRET ist nicht gesetzt. Hinterlege den Stripe Secret Key (sk_…) in der .env, bevor Stripe als Zahlungsanbieter genutzt wird.'
                );
            }
            $this->client = new StripeClient($this->secret);
        }

        return $this->client;
    }

    public function isConfigured(): bool
    {
        return $this->secret !== null && trim($this->secret) !== '';
    }
}