<?php

declare(strict_types=1);

namespace Drupal\Tests\field\Kernel;

use Drupal\Component\Plugin\Exception\PluginNotFoundException;
use Drupal\Core\Config\Action\ConfigActionException;
use Drupal\Core\Entity\EntityFieldManagerInterface;
use Drupal\Core\Entity\EntityTypeManagerInterface;
use Drupal\Core\Recipe\RecipeRunner;
use Drupal\entity_test\Entity\EntityTest;
use Drupal\entity_test\EntityTestHelper;
use Drupal\field\Entity\FieldConfig;
use Drupal\field\Entity\FieldStorageConfig;
use Drupal\field\Plugin\ConfigAction\AddToAllBundles;
use Drupal\FunctionalTests\Core\Recipe\RecipeTestTrait;
use Drupal\KernelTests\KernelTestBase;
use Drupal\Tests\field\Traits\BodyFieldCreationTrait;
use PHPUnit\Framework\Attributes\CoversClass;
use PHPUnit\Framework\Attributes\Group;
use PHPUnit\Framework\Attributes\RunTestsInSeparateProcesses;

/**
 * Tests Add To All Bundles Config Action.
 */
#[Group('Recipe')]
#[Group('field')]
#[CoversClass(AddToAllBundles::class)]
#[RunTestsInSeparateProcesses]
class AddToAllBundlesConfigActionTest extends KernelTestBase {

  use BodyFieldCreationTrait;
  use RecipeTestTrait;

  /**
   * {@inheritdoc}
   */
  protected static $modules = [
    'field',
    'entity_test',
    'entity_test_with_storage',
    'text',
    'user',
  ];

  /**
   * {@inheritdoc}
   */
  protected function setUp(): void {
    parent::setUp();

    $this->installEntitySchema('entity_test');
    EntityTestHelper::createBundle('one');
    EntityTestHelper::createBundle('two');
    EntityTest::create([
      'type' => 'one',
      'name' => 'One',
    ])->save();
    EntityTest::create([
      'type' => 'two',
      'name' => 'Two',
    ])->save();
  }

  /**
   * Tests instantiating a field on all bundles of an entity type.
   */
  public function testInstantiateNewFieldOnAllBundles(): void {
    // Ensure the body field doesn't actually exist yet.
    $storage_definitions = $this->container->get(EntityFieldManagerInterface::class)
      ->getFieldStorageDefinitions('entity_test');
    $this->assertArrayNotHasKey('body', $storage_definitions);

    $this->applyAction('field.storage.entity_test.body');

    // Fields and expected data exist.
    /** @var \Drupal\field\FieldConfigInterface[] $body_fields */
    $body_fields = $this->container->get(EntityTypeManagerInterface::class)
      ->getStorage('field_config')
      ->loadByProperties([
        'entity_type' => 'entity_test',
        'field_name' => 'body',
      ]);
    ksort($body_fields);
    $this->assertSame(['entity_test.entity_test.body', 'entity_test.one.body', 'entity_test.two.body'], array_keys($body_fields));
    foreach ($body_fields as $field) {
      $this->assertSame('Body field label', $field->label());
      $this->assertSame('Set by config actions.', $field->getDescription());
    }

    // Expect an error when the 'addToAllBundles' action is invoked on anything
    // other than a field storage config entity.
    $this->expectException(PluginNotFoundException::class);
    $this->expectExceptionMessage('The "user_role" entity does not support the "addToAllBundles" config action.');
    $this->applyAction('user.role.anonymous');
  }

  /**
   * Tests that the action can be set to fail if the field already exists.
   */
  public function testFailIfExists(): void {
    $this->installConfig('entity_test');
    $this->installConfig('entity_test_with_storage');

    $field_storage = FieldStorageConfig::loadByName('entity_test', 'body');
    // Manually create the field.
    $field = FieldConfig::create([
      'field_storage' => $field_storage,
      'bundle' => 'one',
      'label' => 'Body',
    ]);
    $field->save();

    $this->expectException(ConfigActionException::class);
    $this->expectExceptionMessage('Field entity_test.one.body already exists.');
    $this->applyAction('field.storage.entity_test.body', TRUE);
  }

  /**
   * Tests that the action will ignore existing fields by default.
   */
  public function testIgnoreExistingFields(): void {
    $this->installConfig('entity_test');
    $this->installConfig('entity_test_with_storage');

    $field_storage = FieldStorageConfig::loadByName('entity_test', 'body');
    // Manually create the field.
    $field = FieldConfig::create([
      'field_storage' => $field_storage,
      'bundle' => 'one',
      'label' => 'Original label',
      'description' => 'Original description',
    ]);
    $field->save();

    $this->applyAction('field.storage.entity_test.body');

    // The existing field should not be changed.
    $field = FieldConfig::loadByName('entity_test', 'one', 'body');
    $this->assertInstanceOf(FieldConfig::class, $field);
    $this->assertSame('Original label', $field->label());
    $this->assertSame('Original description', $field->getDescription());

    // But the new field should be created as expected.
    $field = FieldConfig::loadByName('entity_test', 'two', 'body');
    $this->assertInstanceOf(FieldConfig::class, $field);
    $this->assertSame('Body field label', $field->label());
    $this->assertSame('Set by config actions.', $field->getDescription());
  }

  /**
   * Tests that the action fails when the label property is not set.
   */
  public function testMissingLabel(): void {
    $contents = <<<YAML
name: Instantiate field on all bundles
config:
  import:
    entity_test_with_storage:
      - field.storage.entity_test.body
  actions:
    field.storage.entity_test.body:
      addToAllBundles:
        description: Set by config actions.
YAML;
    $recipe = $this->createRecipe($contents);

    $this->expectException(ConfigActionException::class);
    $this->expectExceptionMessage('The `label` property must be set for entity_test.entity_test.body.');
    RecipeRunner::processRecipe($recipe);
  }

  /**
   * Applies a recipe with the addToAllBundles action.
   *
   * @param string $config_name
   *   The name of the config object which should run the addToAllBundles
   *   action.
   * @param bool $fail_if_exists
   *   (optional) Whether the action should fail if the field already exists on
   *   any bundle. Defaults to FALSE.
   */
  private function applyAction(string $config_name, bool $fail_if_exists = FALSE): void {
    $fail_if_exists = var_export($fail_if_exists, TRUE);
    $contents = <<<YAML
name: Instantiate field on all bundles
config:
  import:
    entity_test_with_storage:
      - field.storage.entity_test.body
  actions:
    $config_name:
      addToAllBundles:
        label: Body field label
        description: Set by config actions.
        fail_if_exists: $fail_if_exists
YAML;
    $recipe = $this->createRecipe($contents);
    RecipeRunner::processRecipe($recipe);
  }

}