presseportale/tests/Pest.php

<?php

use App\Enums\UserPaymentOptionStatus;
use App\Models\Category;
use App\Models\Company;
use App\Models\Contact;
use App\Models\PaymentOption;
use App\Models\Plan;
use App\Models\PressRelease;
use App\Models\User;
use App\Models\UserPaymentOption;
use App\Services\CurrentPortalContext;
use App\Support\WebPageCache;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Laravel\Sanctum\Sanctum;
use Tests\TestCase;

/*
|--------------------------------------------------------------------------
| Test Case
|--------------------------------------------------------------------------
|
| The closure you provide to your test functions is always bound to a specific PHPUnit test
| case class. By default, that class is "PHPUnit\Framework\TestCase". Of course, you may
| need to change it using the "pest()" function to bind a different classes or traits.
|
*/

pest()->extend(TestCase::class)
    ->use(RefreshDatabase::class)
    ->beforeEach(function () {
        // PortalScope-Context zwischen Tests zurücksetzen, damit statischer
        // State aus vorherigen Requests nicht in Volt-Tests durchschlägt.
        CurrentPortalContext::clear();
    })
    ->in('Feature');

/*
|--------------------------------------------------------------------------
| Expectations
|--------------------------------------------------------------------------
|
| When you're writing tests, you often need to check that values meet certain conditions. The
| "expect()" function gives you access to a set of "expectations" methods that you can use
| to assert different things. Of course, you may extend the Expectation API at any time.
|
*/

expect()->extend('toBeOne', function () {
    return $this->toBe(1);
});

/*
|--------------------------------------------------------------------------
| Functions
|--------------------------------------------------------------------------
|
| While Pest is very powerful out-of-the-box, you may have some testing code specific to your
| project that you don't want to repeat in every file. Here you can also expose helpers as
| global functions to help you to reduce the number of lines of code in your test files.
|
*/

function something()
{
    // ..
}

/**
 * Legt offline eine aktive Cashier-Abo-Zeile für den User an (kein
 * Stripe-Aufruf) und verknüpft sie über die Preis-ID mit dem Tarif —
 * `User::currentPlan()` löst darüber auf.
 */
function subscribeUserToPlan(User $user, Plan $plan, string $interval = 'monthly'): void
{
    $priceId = $interval === 'yearly' ? $plan->stripe_price_id_yearly : $plan->stripe_price_id_monthly;

    $user->subscriptions()->create([
        'type' => 'default',
        'stripe_id' => 'sub_test_'.fake()->unique()->randomNumber(6),
        'stripe_status' => 'active',
        'stripe_price' => $priceId,
        'quantity' => 1,
    ]);
}

/**
 * Seiten-Cache-Keys tragen seit der Entfernung mit 410 eine Generations-Nummer
 * (siehe WebPageCache::key): Ein Flush erhöht sie und verwirft damit alle
 * `web.`-Seiten-Caches auf einmal. Die Tests prüfen weiterhin die fachliche
 * Key-Struktur, nur eben generationsunabhängig.
 */
/**
 * API-Zugang setzt eine laufende Buchung voraus (EnsureApiAccessIsBooked,
 * 08.10.2026). Für API-Tests, die nicht die Buchung selbst prüfen: aktive
 * Zahlungsoption anlegen.
 */
function grantApiAccess(User $user): User
{
    UserPaymentOption::factory()->create([
        'user_id' => $user->id,
        'payment_option_id' => PaymentOption::factory()->create()->id,
        'status' => UserPaymentOptionStatus::Active->value,
        'current_period_start' => now()->subDay(),
        'current_period_end' => now()->addMonth(),
    ]);

    return $user;
}

/**
 * Sanctum::actingAs() für einen Nutzer mit gebuchtem API-Zugang.
 *
 * @param  list<string>  $abilities
 */
function apiActingAs(User $user, array $abilities = ['*']): User
{
    return Sanctum::actingAs(grantApiAccess($user), $abilities);
}

function webPageCacheKey(string $key): string
{
    return 'web.g'.WebPageCache::generation().'.'.substr($key, strlen('web.'));
}

/**
 * Kunde (Rolle customer, Owner einer Presseecho-Firma) mit Kontakt, Kategorie
 * und einer Entwurfs-PM. Gemeinsam genutzt von den Phase-8a-/8i-Tests und dem
 * Widerrufsverzicht-Test — deshalb hier und nicht in einer einzelnen Testdatei,
 * sonst scheitern die Nutzer im Einzel- oder Parallellauf.
 *
 * @param  array<string, mixed>  $prAttributes
 * @return array{customer: User, company: Company, contact: Contact, category: Category, pr: PressRelease}
 */
function makeCustomerForShowPhase8a(array $prAttributes = []): array
{
    $customer = User::factory()->create(['is_active' => true]);
    $customer->assignRole('customer');

    $company = Company::factory()->presseecho()->create();
    $customer->companies()->attach($company->id, ['role' => 'owner']);

    $contact = Contact::factory()->for($company)->create([
        'portal' => $company->portal->value,
    ]);
    $category = Category::factory()->create();

    $pr = PressRelease::factory()->create(array_merge([
        'user_id' => $customer->id,
        'company_id' => $company->id,
        'category_id' => $category->id,
        'portal' => $company->portal->value,
        'status' => 'draft',
    ], $prAttributes));

    $pr->contacts()->sync([$contact->id]);

    return compact('customer', 'company', 'contact', 'category', 'pr');
}