DiscoDevBarService.php

<?php

declare(strict_types=1);

/* #############################################################################
 *
 *   █▀▀▄  ▀                     █▀▀▄           █▀▀▄
 *   █  █ ▀█  ▄▀▀▄ ▄▀▀▄ ▄▀▀▄     █  █ ▄▀▀▄ █  █ █▀▀▄ ▄▀▀▄ █▄▀
 *   █  █  █   ▀▄  █    █  █     █  █ █▀▀  █  █ █  █  ▄▄█ █
 *   █▄▄▀ ▄█▄ ▀▄▄▀ ▀▄▄▀ ▀▄▄▀     █▄▄▀ ▀▄▄▀ ▀▄▀  █▄▄▀ ▀▄▄▀ █
 *
 *     Customizable developer toolbar for Symfony projects
 *
 * @author    Marcin Orlowski <mail (#) marcinOrlowski (.) com>
 * @copyright 2025 Marcin Orlowski
 * @license   https://opensource.org/license/mit MIT
 * @link      https://github.com/MarcinOrlowski/php-symfony-discodevbar
 *
 * ########################################################################## */

namespace MarcinOrlowski\DiscoDevBar\Service;

use Composer\InstalledVersions;
use MarcinOrlowski\DiscoDevBar\Dto\DiscoDevBarData;
use MarcinOrlowski\DiscoDevBar\Dto\Widget;
use Symfony\Component\Yaml\Yaml;

class DiscoDevBarService
{
    /**
     * List of supported config filenames (in order of preference)
     */
    private const CONFIG_FILES = [
        '.disco-devbar.yaml',
        '.disco-devbar.yml',
        '.debug-banner.yaml',  // Legacy, kept for backward compatibility
    ];

    /**
     * Default Font Awesome version
     */
    private const DEFAULT_FONT_AWESOME_VERSION = '6.5.1';

    /**
     * Default background colors for breathing stripes
     */
    private const DEFAULT_BG_COLOR_LIGHT = '#b71c1c';
    private const DEFAULT_BG_COLOR_DARK = '#8e0000';

    public function __construct(
        private readonly string $projectDir
    ) {
    }

    public function getDiscoDevBarData(): DiscoDevBarData
    {
        $configPath = $this->findConfigFile();
        $version = $this->getVersion();

        // Default: show error message when no config found
        if ($configPath === null) {
            $errorMessage = 'Config file not found: ' . self::CONFIG_FILES[0];
            return new DiscoDevBarData(
                left:                [],
                right:               [],
                leftExpand:          false,
                rightExpand:         false,
                hasError:            true,
                errorMessage:        $errorMessage,
                version:             $version,
                fontAwesomeEnabled:  false,
                fontAwesomeVersion:  self::DEFAULT_FONT_AWESOME_VERSION,
                bgColorLight:        self::DEFAULT_BG_COLOR_LIGHT,
                bgColorDark:         self::DEFAULT_BG_COLOR_DARK
            );
        }

        $config = Yaml::parseFile($configPath);

        // Ensure config is an array and has the expected structure
        if (!\is_array($config)) {
            $config = [];
        }

        // Extract Font Awesome configuration from YAML
        $fontAwesomeConfig = $config['font_awesome'] ?? [];
        $fontAwesomeEnabled = false;
        $fontAwesomeVersion = self::DEFAULT_FONT_AWESOME_VERSION;

        if (\is_array($fontAwesomeConfig)) {
            $fontAwesomeEnabled = $fontAwesomeConfig['enabled'] ?? false;
            // Use user's version if provided and not null, otherwise use default
            $userVersion = $fontAwesomeConfig['version'] ?? null;
            if ($userVersion !== null && \is_string($userVersion)) {
                $fontAwesomeVersion = $userVersion;
            }
        }

        $widgets = $config['widgets'] ?? [];
        if (!\is_array($widgets)) {
            $widgets = [];
        }

        $left = $widgets['left'] ?? [];
        $right = $widgets['right'] ?? [];

        $leftWidgets = $this->loadWidgets(\is_array($left) ? $left : []);
        $rightWidgets = $this->loadWidgets(\is_array($right) ? $right : []);

        $bgColorLight = $config['bg_color_light'] ?? self::DEFAULT_BG_COLOR_LIGHT;
        $bgColorDark = $config['bg_color_dark'] ?? self::DEFAULT_BG_COLOR_DARK;

        return new DiscoDevBarData(
            left:                $leftWidgets,
            right:               $rightWidgets,
            leftExpand:          $this->hasExpandingWidget($leftWidgets),
            rightExpand:         $this->hasExpandingWidget($rightWidgets),
            hasError:            false,
            errorMessage:        '',
            version:             $version,
            fontAwesomeEnabled:  \is_bool($fontAwesomeEnabled) ? $fontAwesomeEnabled : false,
            fontAwesomeVersion:  $fontAwesomeVersion,
            bgColorLight:        \is_string($bgColorLight) ? $bgColorLight : self::DEFAULT_BG_COLOR_LIGHT,
            bgColorDark:         \is_string($bgColorDark) ? $bgColorDark : self::DEFAULT_BG_COLOR_DARK
        );
    }

    /**
     * Find the first existing config file from the list of supported filenames
     *
     * @return string|null Full path to config file or null if none found
     */
    private function findConfigFile(): ?string
    {
        foreach (self::CONFIG_FILES as $filename) {
            $path = $this->projectDir . '/' . $filename;
            if (\file_exists($path)) {
                return $path;
            }
        }

        return null;
    }

    /**
     * Check if any widget in the array has expand=true
     *
     * @param array<Widget> $widgets
     */
    private function hasExpandingWidget(array $widgets): bool
    {
        foreach ($widgets as $widget) {
            if ($widget->expand) {
                return true;
            }
        }

        return false;
    }

    /**
     * Load and normalize widgets from configuration array
     *
     * @param array<mixed> $widgetsData
     *
     * @return array<Widget>
     */
    private function loadWidgets(array $widgetsData): array
    {
        return \array_map(
            function ($widgetData): Widget {
                /** @var array<string, mixed> $data */
                $data = \is_array($widgetData) ? $widgetData : [];
                return Widget::fromArray($data);
            },
            $widgetsData
        );
    }

    /**
     * Get bundle version from Composer
     */
    private function getVersion(): string
    {
        try {
            $version = InstalledVersions::getVersion('marcin-orlowski/symfony-discodevbar');
            return $version ?? 'dev';
        } catch (\Exception $e) {
            return 'dev';
        }
    }
}