<?php

/*
 * Copyright 2005 - 2023 Centreon (https://www.centreon.com/)
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * https://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
 * For more information : contact@centreon.com
 *
 */

declare(strict_types=1);

namespace Core\HostCategory\Infrastructure\Repository;

use Assert\AssertionFailedException;
use Centreon\Domain\Log\LoggerTrait;
use Centreon\Domain\RequestParameters\Interfaces\RequestParametersInterface;
use Centreon\Domain\RequestParameters\RequestParameters;
use Centreon\Infrastructure\DatabaseConnection;
use Centreon\Infrastructure\RequestParameters\SqlRequestParametersTranslator;
use Core\Common\Domain\TrimmedString;
use Core\Common\Infrastructure\Repository\AbstractRepositoryRDB;
use Core\Common\Infrastructure\Repository\SqlMultipleBindTrait;
use Core\Common\Infrastructure\RequestParameters\Normalizer\BoolToEnumNormalizer;
use Core\HostCategory\Application\Repository\ReadHostCategoryRepositoryInterface;
use Core\HostCategory\Domain\Model\HostCategory;
use Core\HostCategory\Domain\Model\HostCategoryNamesById;
use Core\HostGroup\Infrastructure\Repository\HostGroupRepositoryTrait;
use Utility\SqlConcatenator;

/**
 * @phpstan-type _Category array{
 *     hc_id:int,
 *     hc_name:string,
 *     hc_alias:string,
 *     hc_activate:string,
 *     hc_comment:string|null
 * }
 */
class DbReadHostCategoryRepository extends AbstractRepositoryRDB implements ReadHostCategoryRepositoryInterface
{
    use LoggerTrait, SqlMultipleBindTrait, HostGroupRepositoryTrait;

    /**
     * @param DatabaseConnection $db
     */
    public function __construct(DatabaseConnection $db)
    {
        $this->db = $db;
    }

    /**
     * @inheritDoc
     */
    public function findNames(array $hostCategoryIds): HostCategoryNamesById
    {
        $concatenator = new SqlConcatenator();

        $hostCategoryIds = array_unique($hostCategoryIds);

        $concatenator->defineSelect(
            <<<'SQL'
                    SELECT hc.hc_id, hc.hc_name
                    FROM `:db`.hostcategories hc
                    WHERE hc.hc_id IN (:hostCategoryIds)
                SQL
        );

        $concatenator->storeBindValueMultiple(':hostCategoryIds', $hostCategoryIds, \PDO::PARAM_INT);
        $statement = $this->db->prepare($this->translateDbName($concatenator->__toString()));
        $concatenator->bindValuesToStatement($statement);
        $statement->setFetchMode(\PDO::FETCH_ASSOC);
        $statement->execute();

        $names = new HostCategoryNamesById();

        foreach ($statement as $record) {
            /** @var array{hc_id:int,hc_name:string} $record */
            $names->addName(
                $record['hc_id'],
                new TrimmedString($record['hc_name'])
            );
        }

        return $names;
    }

    /**
     * @inheritDoc
     */
    public function findAll(?RequestParametersInterface $requestParameters): array
    {
        $request = <<<'SQL'
            SELECT SQL_CALC_FOUND_ROWS DISTINCT
                hc.hc_id,
                hc.hc_name,
                hc.hc_alias,
                hc.hc_activate,
                hc.hc_comment
            FROM `:db`.hostcategories hc
            SQL;

        // Setup for search, pagination and order
        $sqlTranslator = $requestParameters ? new SqlRequestParametersTranslator($requestParameters) : null;
        $sqlTranslator?->getRequestParameters()->setConcordanceStrictMode(RequestParameters::CONCORDANCE_MODE_STRICT);
        $sqlTranslator?->setConcordanceArray([
            'id' => 'hc.hc_id',
            'name' => 'hc.hc_name',
            'alias' => 'hc.hc_alias',
            'is_activated' => 'hc.hc_activate',
            'hostgroup.id' => 'hg.hg_id',
            'hostgroup.name' => 'hg.hg_name',
        ]);
        $sqlTranslator?->addNormalizer('is_activated', new BoolToEnumNormalizer());

        // Update the SQL string builder with the RequestParameters through SqlRequestParametersTranslator
        $searchRequest = $sqlTranslator?->translateSearchParameterToSql();

        if ($searchRequest !== null) {
            $request .= <<<'SQL'

                    INNER JOIN `:db`.hostcategories_relation hcr
                        ON hc.hc_id = hcr.hostcategories_hc_id
                    INNER JOIN `:db`.hostgroup_relation hgr
                        ON hcr.host_host_id = hgr.host_host_id
                    INNER JOIN `:db`.hostgroup hg
                        ON hgr.hostgroup_hg_id = hg.hg_id
                SQL;
        }

        $request .= $searchRequest !== null ? $searchRequest . ' AND ' : ' WHERE ';

        // avoid severities
        $request .= 'hc.level IS NULL';

        // handle sort
        $request .= $sqlTranslator?->translateSortParameterToSql();

        // handle pagination
        $request .= $sqlTranslator?->translatePaginationToSql();

        $statement = $this->db->prepare($this->translateDbName($request));

        $sqlTranslator?->bindSearchValues($statement);

        $statement->setFetchMode(\PDO::FETCH_ASSOC);
        $statement->execute();

        // Calculate the number of rows for the pagination.
        $sqlTranslator?->calculateNumberOfRows($this->db);

        $hostCategories = [];
        while (is_array($result = $statement->fetch())) {
            /** @var array{hc_id:int,hc_name:string,hc_alias:string,hc_activate:'0'|'1',hc_comment:string|null} $result */
            $hostCategories[] = $this->createHostCategoryFromArray($result);
        }

        return $hostCategories;
    }

    /**
     * @inheritDoc
     */
    public function findAllByAccessGroupIds(array $accessGroupIds, ?RequestParametersInterface $requestParameters): array
    {
        if ($accessGroupIds === []) {
            return [];
        }

        [$bindValues, $bindQuery] = $this->createMultipleBindQuery($accessGroupIds, ':access_group_id_');

        $request = <<<'SQL'
            SELECT SQL_CALC_FOUND_ROWS DISTINCT
                hc.hc_id,
                hc.hc_name,
                hc.hc_alias,
                hc.hc_activate,
                hc.hc_comment
            FROM `:db`.hostcategories hc
            INNER JOIN `:db`.acl_resources_hc_relations arhr
                ON hc.hc_id = arhr.hc_id
            INNER JOIN `:db`.acl_resources res
                ON arhr.acl_res_id = res.acl_res_id
            INNER JOIN `:db`.acl_res_group_relations argr
                ON res.acl_res_id = argr.acl_res_id
            INNER JOIN `:db`.acl_groups ag
                ON argr.acl_group_id = ag.acl_group_id
            SQL;

        // Setup for search, pagination and order
        $sqlTranslator = $requestParameters ? new SqlRequestParametersTranslator($requestParameters) : null;
        $sqlTranslator?->getRequestParameters()->setConcordanceStrictMode(RequestParameters::CONCORDANCE_MODE_STRICT);
        $sqlTranslator?->setConcordanceArray([
            'id' => 'hc.hc_id',
            'name' => 'hc.hc_name',
            'alias' => 'hc.hc_alias',
            'is_activated' => 'hc.hc_activate',
            'hostgroup.id' => 'hg.hg_id',
            'hostgroup.name' => 'hg.hg_name',
        ]);
        $sqlTranslator?->addNormalizer('is_activated', new BoolToEnumNormalizer());

        // Update the SQL string builder with the RequestParameters through SqlRequestParametersTranslator
        $searchRequest = $sqlTranslator?->translateSearchParameterToSql();

        if ($searchRequest !== null) {
            $request .= <<<'SQL'
                    INNER JOIN `:db`.hostcategories_relation hcr
                        ON hc.hc_id = hcr.hostcategories_hc_id
                    INNER JOIN `:db`.hostgroup_relation hgr
                        ON hcr.host_host_id = hgr.host_host_id
                    INNER JOIN `:db`.hostgroup hg
                        ON hgr.hostgroup_hg_id = hg.hg_id
                SQL;

            if (! $this->hasAccessToAllHostGroups($accessGroupIds)) {
                $hostGroupAcl = $this->generateHostGroupAclSubRequest($accessGroupIds);
                $request .= <<<SQL
                        AND hgr.hostgroup_hg_id IN ({$hostGroupAcl})
                    SQL;
            }
        }

        $request .= $searchRequest !== null
            ? $searchRequest . ' AND '
            : ' WHERE ';

        // avoid severities
        $request .= "hc.level IS NULL AND ag.acl_group_id IN ({$bindQuery})";

        // handle sort
        $request .= $sqlTranslator?->translateSortParameterToSql();

        // handle pagination
        $request .= $sqlTranslator?->translatePaginationToSql();

        $statement = $this->db->prepare($this->translateDbName($request));

        $sqlTranslator?->bindSearchValues($statement);

        foreach ($bindValues as $key => $value) {
            $statement->bindValue($key, $value, \PDO::PARAM_INT);
        }

        $statement->setFetchMode(\PDO::FETCH_ASSOC);
        $statement->execute();

        // Calculate the number of rows for the pagination.
        $sqlTranslator?->calculateNumberOfRows($this->db);

        $hostCategories = [];
        while (is_array($result = $statement->fetch())) {
            /** @var array{hc_id:int,hc_name:string,hc_alias:string,hc_activate:'0'|'1',hc_comment:string|null} $result */
            $hostCategories[] = $this->createHostCategoryFromArray($result);
        }

        return $hostCategories;
    }

    /**
     * @inheritDoc
     */
    public function exists(int $hostCategoryId): bool
    {
        $this->info('Check existence of host category with id #' . $hostCategoryId);

        $request = $this->translateDbName(
            'SELECT 1 FROM `:db`.hostcategories hc WHERE hc.hc_id = :hostCategoryId AND hc.level IS NULL'
        );
        $statement = $this->db->prepare($request);
        $statement->bindValue(':hostCategoryId', $hostCategoryId, \PDO::PARAM_INT);
        $statement->execute();

        return (bool) $statement->fetchColumn();
    }

    /**
     * @inheritDoc
     */
    public function existsByAccessGroups(int $hostCategoryId, array $accessGroups): bool
    {
        $this->info(
            'Check existence of host category by access groups',
            ['id' => $hostCategoryId, 'accessgroups' => $accessGroups]
        );

        if (empty($accessGroups)) {
            $this->debug('Access groups array empty');

            return false;
        }

        $concat = new SqlConcatenator();

        $accessGroupIds = array_map(
            fn ($accessGroup) => $accessGroup->getId(),
            $accessGroups
        );

        // if host categories are not filtered in ACLs, then user has access to ALL host categories
        if (! $this->hasAclFilterOnHostCategories($accessGroupIds)) {
            $this->info('Host categories access not filtered');

            return $this->exists($hostCategoryId);
        }

        $request = $this->translateDbName(
            'SELECT 1
            FROM `:db`.hostcategories hc
            INNER JOIN `:db`.acl_resources_hc_relations arhr
                ON hc.hc_id = arhr.hc_id
            INNER JOIN `:db`.acl_resources res
                ON arhr.acl_res_id = res.acl_res_id
            INNER JOIN `:db`.acl_res_group_relations argr
                ON res.acl_res_id = argr.acl_res_id
            INNER JOIN `:db`.acl_groups ag
                ON argr.acl_group_id = ag.acl_group_id'
        );
        $concat->appendWhere('hc.hc_id = :hostCategoryId');
        $concat->appendWhere('hc.level IS NULL');

        $concat->storeBindValueMultiple(':access_group_ids', $accessGroupIds, \PDO::PARAM_INT)
            ->appendWhere('ag.acl_group_id IN (:access_group_ids)');

        $statement = $this->db->prepare($this->translateDbName($request . ' ' . $concat));
        foreach ($concat->retrieveBindValues() as $param => [$value, $type]) {
            $statement->bindValue($param, $value, $type);
        }
        $statement->bindValue(':hostCategoryId', $hostCategoryId, \PDO::PARAM_INT);

        $statement->execute();

        return (bool) $statement->fetchColumn();
    }

    /**
     * @inheritDoc
     */
    public function exist(array $hostCategoryIds): array
    {
        $this->info('Check existence of host categories', ['host_category_ids' => $hostCategoryIds]);

        if ($hostCategoryIds === []) {
            return [];
        }

        $concatenator = new SqlConcatenator();
        $concatenator
            ->defineSelect(
                <<<'SQL'
                    SELECT hc.hc_id FROM `:db`.`hostcategories` hc
                    SQL
            )
            ->appendWhere('hc.hc_id IN (:host_category_ids)')
            ->appendWhere('hc.level IS NULL')
            ->storeBindValueMultiple(':host_category_ids', $hostCategoryIds, \PDO::PARAM_INT);

        $statement = $this->db->prepare($this->translateDbName($concatenator->__toString()));
        $concatenator->bindValuesToStatement($statement);
        $statement->execute();

        return $statement->fetchAll(\PDO::FETCH_COLUMN);
    }

    /**
     * @inheritDoc
     */
    public function existByAccessGroups(array $hostCategoryIds, array $accessGroups): array
    {
        $this->info(
            'Check existence of host category by access groups',
            ['host_category_ids' => $hostCategoryIds, 'accessgroups' => $accessGroups]
        );

        if ($hostCategoryIds === []) {
            return [];
        }

        if (empty($accessGroups)) {
            $this->debug('Access groups array empty');

            return [];
        }

        $accessGroupIds = array_map(
            fn ($accessGroup) => $accessGroup->getId(),
            $accessGroups
        );

        // if host categories are not filtered in ACLs, then user has access to ALL host categories
        if (! $this->hasAclFilterOnHostCategories($accessGroupIds)) {
            $this->info('Host categories access not filtered');

            return $this->exist($hostCategoryIds);
        }

        $concatenator = new SqlConcatenator();
        $concatenator
            ->defineSelect(
                <<<'SQL'
                    SELECT arhr.hc_id
                    FROM `:db`.`hostcategories` hc
                    INNER JOIN `:db`.`acl_resources_hc_relations` arhr
                        ON hc.hc_id = arhr.hc_id
                    INNER JOIN `:db`.`acl_resources` res
                        ON arhr.acl_res_id = res.acl_res_id
                    INNER JOIN `:db`.`acl_res_group_relations` argr
                        ON res.acl_res_id = argr.acl_res_id
                    INNER JOIN `:db`.`acl_groups` ag
                        ON argr.acl_group_id = ag.acl_group_id
                    SQL
            )
            ->appendWhere('hc.hc_id IN (:host_category_ids)')
            ->appendWhere('hc.level IS NULL')
            ->appendWhere('ag.acl_group_id IN (:access_group_ids)')
            ->storeBindValueMultiple(':access_group_ids', $accessGroupIds, \PDO::PARAM_INT)
            ->storeBindValueMultiple(':host_category_ids', $hostCategoryIds, \PDO::PARAM_INT);

        $statement = $this->db->prepare($this->translateDbName($concatenator->__toString()));
        $concatenator->bindValuesToStatement($statement);
        $statement->execute();

        return $statement->fetchAll(\PDO::FETCH_COLUMN);
    }

    /**
     * @inheritDoc
     */
    public function existsByName(TrimmedString $hostCategoryName): bool
    {
        $this->info('Check existence of host category with name ' . $hostCategoryName);

        $request = $this->translateDbName(
            'SELECT 1 FROM `:db`.hostcategories hc WHERE hc.hc_name = :hostCategoryName'
        );
        $statement = $this->db->prepare($request);
        $statement->bindValue(':hostCategoryName', $hostCategoryName->value, \PDO::PARAM_STR);
        $statement->execute();

        return (bool) $statement->fetchColumn();
    }

    /**
     * {@inheritDoc}
     *
     * @throws AssertionFailedException
     */
    public function findById(int $hostCategoryId): ?HostCategory
    {
        $this->info('Get a host category with ID #' . $hostCategoryId);

        $request = $this->translateDbName(<<<'SQL'
            SELECT hc.hc_id, hc.hc_name, hc.hc_alias, hc.hc_activate, hc.hc_comment
            FROM `:db`.hostcategories hc
            WHERE hc.hc_id = :hostCategoryId
            AND hc.level IS NULL
            SQL
        );
        $statement = $this->db->prepare($request);
        $statement->bindValue(':hostCategoryId', $hostCategoryId, \PDO::PARAM_INT);
        $statement->execute();

        $result = $statement->fetch(\PDO::FETCH_ASSOC);
        if ($result === false) {

            return null;
        }

        /** @var _Category $result */
        return $this->createHostCategoryFromArray($result);
    }

    /**
     * {@inheritDoc}
     *
     * @throws AssertionFailedException
     */
    public function findByIds(int ...$hostCategoryIds): array
    {
        if ($hostCategoryIds === []) {
            return [];
        }

        $bindValues = [];
        foreach ($hostCategoryIds as $index => $categoryId) {
            $bindValues[':hct_' . $index] = $categoryId;
        }

        $hostCategoryIdsQuery = implode(', ',array_keys($bindValues));
        $request = $this->translateDbName(<<<SQL
            SELECT hc.hc_id, hc.hc_name, hc.hc_alias, hc.hc_activate, hc.hc_comment
            FROM `:db`.hostcategories hc
            WHERE hc.hc_id IN ({$hostCategoryIdsQuery})
            AND hc.level IS NULL
            SQL
        );

        $statement = $this->db->prepare($request);
        foreach ($bindValues as $bindKey => $categoryId) {
            $statement->bindValue($bindKey, $categoryId, \PDO::PARAM_INT);
        }
        $statement->setFetchMode(\PDO::FETCH_ASSOC);
        $statement->execute();

        $categories = [];
        foreach ($statement as $result) {
            /** @var _Category $result */
            $categories[] = $this->createHostCategoryFromArray($result);
        }

        return $categories;
    }

    /**
     * @inheritDoc
     */
    public function findByHost(int $hostId): array
    {
        $this->info("Getting host categories linked to a host/host template #{$hostId}");

        $concatenator = new SqlConcatenator();
        $concatenator
            ->defineSelect(
                <<<'SQL'
                    SELECT hc.hc_id, hc.hc_name, hc.hc_alias, hc.hc_activate, hc.hc_comment
                    FROM `:db`.hostcategories hc
                    JOIN `:db`.hostcategories_relation hcr
                        ON hc.hc_id = hcr.hostcategories_hc_id
                    SQL
            )
            ->appendWhere('hcr.host_host_id = :host_id')
            ->storeBindValue(':host_id', $hostId, \PDO::PARAM_INT);

        return $this->retrieveHostCategories($concatenator, null);
    }

    /**
     * @inheritDoc
     */
    public function findByHostAndAccessGroups(int $hostId, array $accessGroups): array
    {
        $this->info(
            "Getting host categories linked to host/host template #{$hostId} by access groups",
            ['access_groups' => $accessGroups]
        );

        if ($accessGroups === []) {
            $this->debug('No access group for this user, return empty');

            return [];
        }

        $accessGroupIds = array_map(
            fn ($accessGroup) => $accessGroup->getId(),
            $accessGroups
        );

        // if host categories are not filtered in ACLs, then user has access to ALL host categories
        if (! $this->hasAclFilterOnHostCategories($accessGroupIds)) {
            $this->info('Host categories access not filtered');

            return $this->findByHost($hostId);
        }

        $concatenator = new SqlConcatenator();
        $concatenator
            ->defineSelect(
                <<<'SQL'
                    SELECT hc.hc_id, hc.hc_name, hc.hc_alias, hc.hc_activate, hc.hc_comment
                    FROM `:db`.hostcategories hc
                    JOIN `:db`.hostcategories_relation hcr
                        ON hc.hc_id = hcr.hostcategories_hc_id
                    INNER JOIN `:db`.acl_resources_hc_relations arhr
                        ON hc.hc_id = arhr.hc_id
                    INNER JOIN `:db`.acl_resources res
                        ON arhr.acl_res_id = res.acl_res_id
                    INNER JOIN `:db`.acl_res_group_relations argr
                        ON res.acl_res_id = argr.acl_res_id
                    INNER JOIN `:db`.acl_groups ag
                        ON argr.acl_group_id = ag.acl_group_id
                    SQL
            )
            ->appendWhere('hcr.host_host_id = :host_id AND hc.level IS NULL')
            ->appendWhere('ag.acl_group_id IN (:access_group_ids)')
            ->storeBindValue(':host_id', $hostId, \PDO::PARAM_INT)
            ->storeBindValueMultiple(':access_group_ids', $accessGroupIds, \PDO::PARAM_INT);

        return $this->retrieveHostCategories($concatenator, null);
    }

    /**
     * @inheritDoc
     */
    public function hasAclFilterOnHostCategories(array $accessGroupIds): bool
    {
        [$bindValues, $bindQuery] = $this->createMultipleBindQuery($accessGroupIds, ':access_group_id_');

        $request = <<<SQL
            SELECT 1
            FROM `:db`.acl_resources_hc_relations arhr
            INNER JOIN `:db`.acl_resources res
                ON arhr.acl_res_id = res.acl_res_id
            INNER JOIN `:db`.acl_res_group_relations argr
                ON res.acl_res_id = argr.acl_res_id
            INNER JOIN `:db`.acl_groups ag
                ON argr.acl_group_id = ag.acl_group_id
            WHERE ag.acl_group_id IN ({$bindQuery})
            SQL;

        $statement = $this->db->prepare($this->translateDbName($request));

        foreach ($bindValues as $key => $value) {
            $statement->bindValue($key, $value, \PDO::PARAM_INT);
        }

        $statement->setFetchMode(\PDO::FETCH_ASSOC);
        $statement->execute();

        return (bool) $statement->fetchColumn();
    }

    /**
     * @param int[] $accessGroupIds
     *
     * @return bool
     */
    private function hasAccessToAllHostGroups(array $accessGroupIds): bool
    {
        [$bindValues, $bindQuery] = $this->createMultipleBindQuery($accessGroupIds, ':access_group_id_');

        $request = <<<SQL
                SELECT res.all_hostgroups
                FROM `:db`.acl_resources res
                INNER JOIN `:db`.acl_res_group_relations argr
                    ON argr.acl_res_id = res.acl_res_id
                INNER JOIN `:db`.acl_groups ag
                    ON ag.acl_group_id = argr.acl_group_id
                WHERE ag.acl_group_id IN ({$bindQuery})
            SQL;

        $statement = $this->db->prepare($this->translateDbName($request));

        foreach ($bindValues as $key => $value) {
            $statement->bindValue($key, $value, \PDO::PARAM_INT);
        }

        $statement->setFetchMode(\PDO::FETCH_ASSOC);
        $statement->execute();

        return (bool) $statement->fetchColumn();
    }

    /**
     * @param SqlConcatenator $concatenator
     * @param RequestParametersInterface|null $requestParameters
     *
     * @return HostCategory[]
     */
    private function retrieveHostCategories(
        SqlConcatenator $concatenator,
        ?RequestParametersInterface $requestParameters
    ): array {
        // Exclude severities from the results
        $concatenator->appendWhere('hc.level IS NULL');

        // Settup for search, pagination, order
        $sqlTranslator = $requestParameters ? new SqlRequestParametersTranslator($requestParameters) : null;
        $sqlTranslator?->getRequestParameters()->setConcordanceStrictMode(RequestParameters::CONCORDANCE_MODE_STRICT);
        $sqlTranslator?->setConcordanceArray([
            'id' => 'hc.hc_id',
            'name' => 'hc.hc_name',
            'alias' => 'hc.hc_alias',
            'is_activated' => 'hc.hc_activate',
        ]);
        $sqlTranslator?->addNormalizer('is_activated', new BoolToEnumNormalizer());
        $sqlTranslator?->translateForConcatenator($concatenator);

        $statement = $this->db->prepare($this->translateDbName($concatenator->__toString()));

        $sqlTranslator?->bindSearchValues($statement);
        $concatenator->bindValuesToStatement($statement);
        $statement->execute();

        $sqlTranslator?->calculateNumberOfRows($this->db);

        $hostCategories = [];
        while (is_array($result = $statement->fetch(\PDO::FETCH_ASSOC))) {
            /** @var array{hc_id:int,hc_name:string,hc_alias:string,hc_activate:'0'|'1',hc_comment:string|null} $result */
            $hostCategories[] = $this->createHostCategoryFromArray($result);
        }

        return $hostCategories;
    }

    /**
     * @param _Category $result
     *
     * @return HostCategory
     */
    private function createHostCategoryFromArray(array $result): HostCategory
    {
        $hostCategory = new HostCategory(
            $result['hc_id'],
            $result['hc_name'],
            $result['hc_alias']
        );
        $hostCategory->setActivated((bool) $result['hc_activate']);
        $hostCategory->setComment($result['hc_comment']);

        return $hostCategory;
    }
}
