PHPUnit, Pest та Brain Monkey з ШІ: 100% покриття WP-логіки

<?php
declare(strict_types=1);

/**
* Author: Artur Yusupov (Fullstack Agentic Lab)
* Package: @agentic-lab/testing-suite
* Module: SubscriptionServiceTest
* Standard: Pest PHP 3 / PHPUnit 11 / Brain Monkey / PHP 8.4
*/

// ==========================================
// 1. Тестируемый класс (Production Service)
// ==========================================
namespace AgenticLab\Membership\Service;

use InvalidArgumentException;
use RuntimeException;

final readonly class SubscriptionService
{
  /**
   * Продление подписки пользователя с расчетом скидок и отправкой уведомления.
   */
  public function renewSubscription(int $userId, float $basePrice): float
  {
      if ($userId <= 0) {
          throw new InvalidArgumentException('Некорректный ID пользователя.');
      }

      // Извлечение ставки налога из опций WordPress
      $taxRate = (float) get_option('agentic_default_tax_rate', 20.0);

      // Расчет базовой стоимости с налогом
      $priceWithTax = $basePrice * (1 + ($taxRate / 100));

      // Применение кастомного фильтра WordPress для скидок
      $finalPrice = (float) apply_filters('agentic_renew_final_price', $priceWithTax, $userId);

      if ($finalPrice < 0) {
          throw new RuntimeException('Итоговая стоимость не может быть отрицательной.');
      }

      // Триггер доменного события через хук WordPress
      do_action('agentic_subscription_renewed', $userId, $finalPrice);

      // Отправка email уведомления
      $adminEmail = (string) get_option('admin_email', '[email protected]');
      wp_mail(
          $adminEmail,
          'Подписка успешно продлена',
          "Пользователь #{$userId} продлил подписку на сумму {$finalPrice}."
      );

      return round($finalPrice, 2);
  }
}

// ==========================================
// 2. Тестовый набор Pest PHP + Brain Monkey
// ==========================================
namespace AgenticLab\Membership\Tests;

use AgenticLab\Membership\Service\SubscriptionService;
use Brain\Monkey;
use Brain\Monkey\Functions;
use Brain\Monkey\Filters;
use Brain\Monkey\Actions;
use InvalidArgumentException;
use RuntimeException;

beforeEach(function (): void {
  // Инициализация песочницы моков Brain Monkey перед каждым тестом
  Monkey\setUp();
});

afterEach(function (): void {
  // Обязательная очистка состояния моков для исключения утечек памяти
  Monkey\tearDown();
});

it('успешно рассчитывает продление с налогом и отправляет email', function (): void {
  // 1. Настройка моков функций ядра WordPress
  Functions\when('get_option')
      ->alias(function (string $option, mixed $default = false): mixed {
          return match ($option) {
              'agentic_default_tax_rate' => 10.0, // Налог 10%
              'admin_email'              => '[email protected]',
              default                    => $default,
          };
      });

  // 2. Мокирование фильтра WordPress
  Filters\expectApplied('agentic_renew_final_price')
      ->once()
      ->with(110.0, 42) // 100 + 10% налог
      ->andReturn(99.0); // Скидочный промокод дает 99.0

  // 3. Ожидание вызова экшена ядра
  Actions\expectDone('agentic_subscription_renewed')
      ->once()
      ->with(42, 99.0);

  // 4. Ожидание отправки email
  Functions\expect('wp_mail')
      ->once()
      ->with(
          '[email protected]',
          'Подписка успешно продлена',
          Mockery::type('string')
      )
      ->andReturnTrue();

  // 5. Выполнение сценария
  $service = new SubscriptionService();
  $result = $service->renewSubscription(userId: 42, basePrice: 100.0);

  // 6. Проверка утверждений
  expect($result)->toBe(99.0);
});

it('выбрасывает исключение при передаче невалидного ID пользователя', function (int $invalidUserId): void {
  $service = new SubscriptionService();

  expect(fn() => $service->renewSubscription($invalidUserId, 100.0))
      ->toThrow(InvalidArgumentException::class, 'Некорректный ID пользователя.');
})->with([0, -1, -99]);

it('выбрасывает исключение, если фильтр сформировал отрицательную стоимость', function (): void {
  Functions\when('get_option')->justReturn(20.0);

  Filters\expectApplied('agentic_renew_final_price')
      ->once()
      ->andReturn(-50.0); // Аварийный фильтр стороннего плагина

  $service = new SubscriptionService();

  expect(fn() => $service->renewSubscription(userId: 1, basePrice: 50.0))
      ->toThrow(RuntimeException::class, 'Итоговая стоимость не может быть отрицательной.');
});