<?php

// Copyright (C) 2010-2024, the Friendica project
// SPDX-FileCopyrightText: 2010-2024 the Friendica project
//
// SPDX-License-Identifier: AGPL-3.0-or-later

declare(strict_types = 1);

namespace Friendica\Core;

use Dice\Dice;
use Friendica\Core\Addon\Capability\ICanLoadAddons;
use Friendica\Core\Logger\Capability\LogChannel;
use Friendica\Core\Logger\Handler\ErrorHandler;
use Friendica\DI;
use Psr\Log\LoggerInterface;

/**
 * Wrapper for the Dice class to make some basic setups
 */
class Container
{
	private Dice $container;

	protected function __construct(Dice $container)
	{
		$this->container = $container;
	}

	/**
	 * Creates an instance with Dice
	 *
	 * @param Dice $container
	 *
	 * @return self
	 */
	public static function fromDice(Dice $container): self {
		return new static($container);
	}

	/**
	 * Initialize the container with the given parameters
	 *
	 * @param string $logChannel The Log Channel of this call
	 * @param bool   $withTemplateEngine true, if the template engine should be set too
	 *
	 * @return void
	 */
	public function setup(string $logChannel = LogChannel::DEFAULT, bool $withTemplateEngine = true)
	{
		$this->setupContainerForAddons();
		$this->setupContainerForLogger($logChannel);
		$this->setupLegacyServiceLocator();
		$this->registerErrorHandler();

		if ($withTemplateEngine) {
			$this->registerTemplateEngine();
		}
	}

	/**
	 * Returns a fully constructed object based on $name using $args and $share as constructor arguments if supplied
	 * @param string $name  name The name of the class to instantiate
	 * @param array  $args  An array with any additional arguments to be passed into the constructor upon instantiation
	 * @param array  $share a list of defined in shareInstances for objects higher up the object graph, should only be used internally
	 * @return object A fully constructed object based on the specified input arguments
	 *
	 * @see Dice::create()
	 */
	public function create(string $name, array $args = [], array $share = []): object
	{
		return $this->container->create($name, $args, $share);
	}

	/**
	 * Add a rule $rule to the class $name
	 * @param string $name The name of the class to add the rule for
	 * @param array  $rule The container can be fully configured using rules provided by associative arrays. See {@link https://r.je/dice.html#example3} for a description of the rules.
	 *
	 * @see Dice::addRule()
	 */
	public function addRule(string $name, array $rule):void
	{
		$this->container = $this->container->addRule($name, $rule);
	}

	private function setupContainerForAddons(): void
	{
		/** @var ICanLoadAddons $addonLoader */
		$addonLoader = $this->container->create(ICanLoadAddons::class);

		$this->container = $this->container->addRules($addonLoader->getActiveAddonConfig('dependencies'));
	}

	private function setupContainerForLogger(string $logChannel): void
	{
		$this->container = $this->container->addRule(LoggerInterface::class, [
			'constructParams' => [$logChannel],
		]);
	}

	private function setupLegacyServiceLocator(): void
	{
		DI::init($this->container);
	}

	private function registerErrorHandler(): void
	{
		ErrorHandler::register($this->container->create(LoggerInterface::class));
	}

	private function registerTemplateEngine(): void
	{
		Renderer::registerTemplateEngine('Friendica\Render\FriendicaSmartyEngine');
	}
}