class StageFixtureManipulator

final class StageFixtureManipulator extends FixtureManipulator implements BeginnerInterface {
    
    /**
     * The state key to use.
     */
    private const STATE_KEY = __CLASS__ . 'MANIPULATOR_ARGUMENTS';
    
    /**
     * The state service.
     *
     * @var \Drupal\Core\State\StateInterface
     */
    private StateInterface $state;
    
    /**
     * The decorated service.
     *
     * @var \PhpTuf\ComposerStager\API\Core\BeginnerInterface
     */
    private BeginnerInterface $inner;
    
    /**
     * Constructions a StageFixtureManipulator object.
     *
     * @param \Drupal\Core\State\StateInterface $state
     *   The state service.
     * @param \PhpTuf\ComposerStager\API\Core\BeginnerInterface $inner
     *   The decorated beginner service.
     */
    public function __construct(StateInterface $state, BeginnerInterface $inner) {
        $this->state = $state;
        $this->inner = $inner;
    }
    
    /**
     * {@inheritdoc}
     */
    public function begin(PathInterface $activeDir, PathInterface $stagingDir, ?PathListInterface $exclusions = NULL, ?OutputCallbackInterface $callback = NULL, ?int $timeout = ProcessInterface::DEFAULT_TIMEOUT) : void {
        $this->inner
            ->begin($activeDir, $stagingDir, $exclusions, $callback, $timeout);
        if ($this->getQueuedManipulationItems()) {
            $this->doCommitChanges($stagingDir->absolute());
        }
    }
    
    /**
     * {@inheritdoc}
     */
    public function commitChanges(string $dir, bool $validate_composer = FALSE) : self {
        throw new \BadMethodCallException('::commitChanges() should not be called directly in StageFixtureManipulator().');
    }
    
    /**
     * {@inheritdoc}
     */
    public function __destruct() {
        // Overrides `__destruct` because the staged fixture manipulator service
        // will be destroyed after every request.
        // @see \Drupal\fixture_manipulator\StageFixtureManipulator::handleTearDown()
    }
    
    /**
     * Handles test tear down to ensure all changes were committed.
     */
    public static function handleTearDown() : void {
        if (!empty(\Drupal::state()->get(self::STATE_KEY))) {
            throw new \LogicException('The StageFixtureManipulator has arguments that were not cleared. This likely means that the PostCreateEvent was never fired.');
        }
    }
    
    /**
     * {@inheritdoc}
     */
    protected function queueManipulation(string $method, array $arguments) : void {
        $stored_arguments = $this->getQueuedManipulationItems();
        $stored_arguments[$method][] = $arguments;
        $this->state
            ->set(self::STATE_KEY, $stored_arguments);
    }
    
    /**
     * {@inheritdoc}
     */
    protected function clearQueuedManipulationItems() : void {
        $this->state
            ->delete(self::STATE_KEY);
    }
    
    /**
     * {@inheritdoc}
     */
    protected function getQueuedManipulationItems() : array {
        return $this->state
            ->get(self::STATE_KEY, []);
    }

}