<?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\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
 */
final class DiceContainer implements Container
{
	public static function fromBasePath(string $basePath): self
	{
		$path = $basePath . '/static/dependencies.config.php';

		$dice = (new Dice())->addRules(require($path));

		return new self($dice);
	}

	private Dice $container;

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

	/**
	 * Initialize the container with the given parameters
	 *
	 * @deprecated
	 *
	 * @param string $logChannel The Log Channel of this call
	 *
	 * @return void
	 */
	public function setup(string $logChannel = LogChannel::DEFAULT): void
	{
		$this->setupContainerForLogger($logChannel);
		$this->setupLegacyServiceLocator();
		$this->registerErrorHandler();
	}

	/**
	 * 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 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));
	}
}