<?php

/*
 * Copyright 2005 - 2025 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\Dashboard\Infrastructure\Repository;

use Adaptation\Database\Connection\ValueObject\QueryParameter;
use Assert\AssertionFailedException;
use Centreon\Domain\Contact\Interfaces\ContactInterface;
use Centreon\Domain\Log\LoggerTrait;
use Centreon\Domain\Repository\RepositoryException;
use Centreon\Domain\RequestParameters\Interfaces\RequestParametersInterface;
use Centreon\Domain\RequestParameters\RequestParameters;
use Centreon\Infrastructure\DatabaseConnection;
use Centreon\Infrastructure\Repository\AbstractRepositoryDRB;
use Centreon\Infrastructure\RequestParameters\SqlRequestParametersTranslator;
use Core\Common\Domain\Exception\RepositoryException as CoreRepositoryException;
use Core\Common\Infrastructure\Repository\SqlMultipleBindTrait;
use Core\Common\Infrastructure\RequestParameters\Transformer\SearchRequestParametersTransformer;
use Core\Contact\Domain\Model\ContactGroup;
use Core\Dashboard\Application\Repository\ReadDashboardShareRepositoryInterface;
use Core\Dashboard\Domain\Model\Dashboard;
use Core\Dashboard\Domain\Model\DashboardRights;
use Core\Dashboard\Domain\Model\Role\DashboardContactGroupRole;
use Core\Dashboard\Domain\Model\Role\DashboardContactRole;
use Core\Dashboard\Domain\Model\Role\DashboardGlobalRole;
use Core\Dashboard\Domain\Model\Role\DashboardSharingRole;
use Core\Dashboard\Domain\Model\Share\DashboardContactGroupShare;
use Core\Dashboard\Domain\Model\Share\DashboardContactShare;
use Core\Dashboard\Domain\Model\Share\DashboardSharingRoles;
use Core\Dashboard\Infrastructure\Model\DashboardGlobalRoleConverter;
use Core\Dashboard\Infrastructure\Model\DashboardSharingRoleConverter;
use Utility\SqlConcatenator;

class DbReadDashboardShareRepository extends AbstractRepositoryDRB implements ReadDashboardShareRepositoryInterface
{
    use LoggerTrait;
    use SqlMultipleBindTrait;

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

    public function findDashboardContactSharesByRequestParameter(
        Dashboard $dashboard,
        RequestParametersInterface $requestParameters,
    ): array {
        $requestParameters->setConcordanceStrictMode(RequestParameters::CONCORDANCE_MODE_STRICT);
        $sqlTranslator = new SqlRequestParametersTranslator($requestParameters);
        $sqlTranslator->setConcordanceArray([
            'id' => 'c.contact_id',
            'name' => 'c.contact_name',
            'email' => 'c.contact_email',
        ]);

        $concatenator = (new SqlConcatenator())
            ->defineSelect(
                <<<'SQL'
                    SELECT
                        c.`contact_id`,
                        c.`contact_name`,
                        c.`contact_email`,
                        dcr.`role`
                    SQL
            )
            ->defineFrom(
                <<<'SQL'
                    FROM `:db`.`dashboard_contact_relation` dcr
                    SQL
            )
            ->defineJoins(
                <<<'SQL'
                    INNER JOIN `:db`.`contact` c ON c.`contact_id`=dcr.`contact_id`
                    SQL
            )
            ->defineWhere(
                <<<'SQL'
                    WHERE dcr.`dashboard_id` = :dashboard_id
                    SQL
            )
            ->storeBindValue(':dashboard_id', $dashboard->getId(), \PDO::PARAM_INT)
            ->defineOrderBy(
                <<<'SQL'
                    ORDER BY c.`contact_name` ASC
                    SQL
            );

        $sqlTranslator->translateForConcatenator($concatenator);

        $statement = $this->db->prepare($this->translateDbName($concatenator->concatAll()));
        $sqlTranslator->bindSearchValues($statement);
        $concatenator->bindValuesToStatement($statement);
        $statement->setFetchMode(\PDO::FETCH_ASSOC);
        $statement->execute();

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

        // Retrieve data
        $shares = [];
        foreach ($statement as $result) {
            /** @var array{
             *     contact_id: int,
             *     contact_name: string,
             *     contact_email: string,
             *     role: string
             * } $result
             */
            $shares[] = new DashboardContactShare(
                $dashboard,
                $result['contact_id'],
                $result['contact_name'],
                $result['contact_email'],
                $this->stringToRole($result['role'])
            );
        }

        return $shares;
    }

    public function findDashboardContactGroupSharesByRequestParameter(
        Dashboard $dashboard,
        RequestParametersInterface $requestParameters,
    ): array {
        $requestParameters->setConcordanceStrictMode(RequestParameters::CONCORDANCE_MODE_STRICT);
        $sqlTranslator = new SqlRequestParametersTranslator($requestParameters);
        $sqlTranslator->setConcordanceArray([
            'id' => 'cg.cg_id',
            'name' => 'cg.cg_name',
        ]);

        $concatenator = (new SqlConcatenator())
            ->defineSelect(
                <<<'SQL'
                    SELECT DISTINCT
                        cg.`cg_id`,
                        cg.`cg_name`,
                        dcgr.`role`
                    SQL
            )
            ->defineFrom(
                <<<'SQL'
                    FROM `:db`.`dashboard_contactgroup_relation` dcgr
                    SQL
            )
            ->defineJoins(
                <<<'SQL'
                    INNER JOIN `:db`.`contactgroup` cg ON cg.`cg_id`=dcgr.`contactgroup_id`
                    INNER JOIN `:db`.`contactgroup_contact_relation` cgcr ON cg.`cg_id`=cgcr.`contactgroup_cg_id`
                    SQL
            )
            ->defineWhere(
                <<<'SQL'
                    WHERE dcgr.`dashboard_id` = :dashboard_id
                    SQL
            )
            ->storeBindValue(':dashboard_id', $dashboard->getId(), \PDO::PARAM_INT)
            ->defineOrderBy(
                <<<'SQL'
                    ORDER BY cg.`cg_name` ASC
                    SQL
            );

        $sqlTranslator->translateForConcatenator($concatenator);

        $statement = $this->db->prepare($this->translateDbName($concatenator->concatAll()));
        $sqlTranslator->bindSearchValues($statement);
        $concatenator->bindValuesToStatement($statement);
        $statement->setFetchMode(\PDO::FETCH_ASSOC);
        $statement->execute();

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

        // Retrieve data
        $shares = [];
        foreach ($statement as $result) {
            /** @var array{
             *     cg_id: int,
             *     cg_name: string,
             *     role: string
             * } $result
             */
            $shares[] = new DashboardContactGroupShare(
                $dashboard,
                $result['cg_id'],
                $result['cg_name'],
                $this->stringToRole($result['role'])
            );
        }

        return $shares;
    }

    public function getOneSharingRoles(ContactInterface $contact, Dashboard $dashboard): DashboardSharingRoles
    {
        $contactShares = $this->getContactShares($contact, $dashboard);
        $contactGroupShares = $this->getContactGroupShares($contact, $dashboard);
        $dashboardId = $dashboard->getId();

        return new DashboardSharingRoles(
            $dashboard,
            $contactShares[$dashboardId] ?? null,
            $contactGroupShares[$dashboardId] ?? [],
        );
    }

    public function getMultipleSharingRoles(ContactInterface $contact, Dashboard ...$dashboards): array
    {
        $contactShares = $this->getContactShares($contact, ...$dashboards);
        $contactGroupShares = $this->getContactGroupShares($contact, ...$dashboards);

        $objects = [];
        foreach ($dashboards as $dashboard) {
            $dashboardId = $dashboard->getId();

            $objects[$dashboardId] = new DashboardSharingRoles(
                $dashboard,
                $contactShares[$dashboardId] ?? null,
                $contactGroupShares[$dashboardId] ?? [],
            );
        }

        return $objects;
    }

    /**
     * @inheritDoc
     */
    public function findDashboardsContactShares(Dashboard ...$dashboards): array
    {
        if ($dashboards === []) {
            return [];
        }

        $dashboardsById = [];
        foreach ($dashboards as $dashboard) {
            $dashboardsById[$dashboard->getId()] = $dashboard;
        }

        $select = <<<'SQL'
            SELECT
                dcr.`dashboard_id`,
                dcr.`role`,
                c.`contact_id`,
                c.`contact_email`,
                c.`contact_name`
            FROM `:db`.`dashboard_contact_relation` dcr
            INNER JOIN contact c
                ON dcr.contact_id = c.contact_id
            WHERE dcr.`dashboard_id` IN (:dashboard_ids)
            SQL;

        $concatenator = (new SqlConcatenator())
            ->defineSelect($select)
            ->storeBindValueMultiple(':dashboard_ids', array_keys($dashboardsById), \PDO::PARAM_INT);
        $statement = $this->db->prepare($this->translateDbName($concatenator->concatAll()));
        $concatenator->bindValuesToStatement($statement);
        $statement->setFetchMode(\PDO::FETCH_ASSOC);
        $statement->execute();

        // Retrieve data
        $shares = [];
        foreach ($statement as $result) {
            /** @var array{
             *     dashboard_id: int,
             *     role: string,
             *     contact_id: int,
             *     contact_email: string,
             *     contact_name: string
             * } $result
             */
            $dashboardId = $result['dashboard_id'];

            $shares[$dashboardId][] = new DashboardContactShare(
                $dashboardsById[$dashboardId],
                $result['contact_id'],
                $result['contact_name'],
                $result['contact_email'],
                $this->stringToRole($result['role'])
            );
        }

        return $shares;
    }

    /**
     * @inheritDoc
     */
    public function findDashboardsContactSharesByContactIds(array $contactIds, Dashboard ...$dashboards): array
    {
        if ($dashboards === []) {
            return [];
        }

        $dashboardsById = [];
        foreach ($dashboards as $dashboard) {
            $dashboardsById[$dashboard->getId()] = $dashboard;
        }

        $select = <<<'SQL'
            SELECT
                dcr.`dashboard_id`,
                dcr.`role`,
                c.`contact_id`,
                c.`contact_email`,
                c.`contact_name`
            FROM `:db`.`dashboard_contact_relation` dcr
            INNER JOIN contact c
                ON dcr.contact_id = c.contact_id
            WHERE dcr.`dashboard_id` IN (:dashboard_ids)
            AND c.contact_id IN(:contact_ids)
            SQL;

        $concatenator = (new SqlConcatenator())
            ->defineSelect($select)
            ->storeBindValueMultiple(':dashboard_ids', array_keys($dashboardsById), \PDO::PARAM_INT)
            ->storeBindValueMultiple(':contact_ids', $contactIds, \PDO::PARAM_INT);
        $statement = $this->db->prepare($this->translateDbName($concatenator->concatAll()));
        $concatenator->bindValuesToStatement($statement);
        $statement->setFetchMode(\PDO::FETCH_ASSOC);
        $statement->execute();

        // Retrieve data
        $shares = [];
        foreach ($statement as $result) {
            /** @var array{
             *     dashboard_id: int,
             *     role: string,
             *     contact_id: int,
             *     contact_email: string,
             *     contact_name: string
             * } $result
             */
            $dashboardId = $result['dashboard_id'];

            $shares[$dashboardId][] = new DashboardContactShare(
                $dashboardsById[$dashboardId],
                $result['contact_id'],
                $result['contact_name'],
                $result['contact_email'],
                $this->stringToRole($result['role'])
            );
        }

        return $shares;
    }

    /**
     * @inheritDoc
     */
    public function findDashboardsContactGroupShares(Dashboard ...$dashboards): array
    {
        if ($dashboards === []) {
            return [];
        }

        $dashboardsById = [];
        foreach ($dashboards as $dashboard) {
            $dashboardsById[$dashboard->getId()] = $dashboard;
        }

        $select = <<<'SQL'
            SELECT
                cg.`cg_id`,
                cg.`cg_name`,
                dcgr.`dashboard_id`,
                dcgr.`role`
            FROM `:db`.`dashboard_contactgroup_relation` dcgr
                     INNER JOIN `:db`.`contactgroup` cg ON cg.`cg_id`= dcgr.`contactgroup_id`
            WHERE dcgr.`dashboard_id` IN (:dashboard_ids)
            SQL;

        $concatenator = (new SqlConcatenator())
            ->defineSelect($select)
            ->storeBindValueMultiple(':dashboard_ids', array_keys($dashboardsById), \PDO::PARAM_INT);
        $statement = $this->db->prepare($this->translateDbName($concatenator->concatAll()));
        $concatenator->bindValuesToStatement($statement);
        $statement->setFetchMode(\PDO::FETCH_ASSOC);
        $statement->execute();

        // Retrieve data
        $shares = [];
        foreach ($statement as $result) {
            /** @var array{
             *     cg_id: int,
             *     cg_name: string,
             *     dashboard_id: int,
             *     role: string
             * } $result
             */
            $dashboardId = $result['dashboard_id'];
            if (! isset($dashboardsById[$dashboardId])) {
                continue;
            }

            $shares[$dashboardId][] = new DashboardContactGroupShare(
                $dashboardsById[$dashboardId],
                $result['cg_id'],
                $result['cg_name'],
                $this->stringToRole($result['role'])
            );
        }

        return $shares;
    }

    /**
     * @inheritDoc
     */
    public function findDashboardsContactGroupSharesByContact(ContactInterface $contact, Dashboard ...$dashboards): array
    {
        return $this->getContactGroupShares($contact, ...$dashboards);
    }

    /**
     * @inheritDoc
     */
    public function findContactsWithAccessRightByRequestParameters(
        RequestParametersInterface $requestParameters,
    ): array {
        $sqlTranslator = new SqlRequestParametersTranslator($requestParameters);
        $sqlTranslator->getRequestParameters()->setConcordanceStrictMode(RequestParameters::CONCORDANCE_MODE_STRICT);
        $sqlTranslator->setConcordanceArray([
            'name' => 'c.contact_name',
        ]);

        $query = <<<'SQL_WRAP'
            SELECT SQL_CALC_FOUND_ROWS
                GROUP_CONCAT(topology.topology_name) as topologies,
                c.contact_name,
                c.contact_id,
                c.contact_email
            FROM `:db`.contact c
            LEFT JOIN `:db`.contactgroup_contact_relation cgcr
                ON cgcr.contact_contact_id = c.contact_id
            LEFT JOIN `:db`.acl_group_contactgroups_relations gcgr
                ON gcgr.cg_cg_id = cgcr.contactgroup_cg_id
            LEFT JOIN `:db`.acl_group_contacts_relations gcr
                ON gcr.contact_contact_id = c.contact_id
            LEFT JOIN `:db`.acl_groups ag
                ON ag.acl_group_id = gcr.acl_group_id
            LEFT JOIN `:db`.acl_group_topology_relations agtr
                ON (agtr.acl_group_id = gcr.acl_group_id
                    OR agtr.acl_group_id = gcgr.acl_group_id)
            LEFT JOIN `:db`.acl_topology_relations acltr
                ON acltr.acl_topo_id = agtr.acl_topology_id
            LEFT JOIN `:db`.topology
                ON topology.topology_id = acltr.topology_topology_id
            LEFT JOIN `:db`.topology parent
                ON topology.topology_parent = parent.topology_page
            SQL_WRAP;

        $searchRequest = $sqlTranslator->translateSearchParameterToSql();
        $query .= $searchRequest !== null
            ? <<<SQL_WRAP

                {$searchRequest}
                AND c.contact_admin = '0'
                AND c.contact_oreon = '1'
                AND parent.topology_name = 'Dashboards'
                AND topology.topology_name IN ('Viewer','Administrator','Creator')
                AND acltr.access_right IS NOT NULL
                SQL_WRAP
            : <<<'SQL_WRAP'

                WHERE c.contact_admin = '0'
                AND c.contact_oreon = '1'
                AND parent.topology_name = 'Dashboards'
                AND topology.topology_name IN ('Viewer','Administrator','Creator')
                AND acltr.access_right IS NOT NULL
                SQL_WRAP;

        $query .= ' GROUP BY c.contact_id, c.contact_name';

        $query .= $sqlTranslator->translatePaginationToSql();

        $statement = $this->db->prepare($this->translateDbName($query));
        $sqlTranslator->bindSearchValues($statement);
        $statement->execute();

        $result = $this->db->query('SELECT FOUND_ROWS()');
        if ($result !== false && ($total = $result->fetchColumn()) !== false) {
            $sqlTranslator->getRequestParameters()->setTotal((int) $total);
        }

        $dashboardContactRoles = [];
        foreach ($statement as $contactRole) {
            /** @var array{
             *     topologies: string,
             *     contact_name: string,
             *     contact_id: int,
             *     contact_email: string
             * } $contactRole
             */
            $dashboardContactRoles[] = $this->createDashboardContactRole($contactRole);
        }

        return $dashboardContactRoles;
    }

    /**
     * @inheritDoc
     */
    public function findContactsWithAccessRightByContactIds(array $contactIds): array
    {
        $bind = [];
        foreach ($contactIds as $key => $contactId) {
            $bind[':contact_id' . $key] = $contactId;
        }
        if ($bind === []) {
            return [];
        }

        $bindTokenAsString = implode(', ', array_keys($bind));

        $query = <<<SQL
            SELECT SQL_CALC_FOUND_ROWS GROUP_CONCAT(topology.topology_name) as topologies, c.contact_name, c.contact_id, c.contact_email
            FROM `:db`.contact c
            LEFT JOIN `:db`.contactgroup_contact_relation cgcr
                ON cgcr.contact_contact_id = c.contact_id
            LEFT JOIN `:db`.acl_group_contactgroups_relations gcgr
                ON gcgr.cg_cg_id = cgcr.contactgroup_cg_id
            LEFT JOIN `:db`.acl_group_contacts_relations gcr
                ON gcr.contact_contact_id = c.contact_id
            LEFT JOIN `:db`.acl_group_topology_relations agtr
                ON (agtr.acl_group_id = gcr.acl_group_id
                    OR agtr.acl_group_id = gcgr.acl_group_id)
            LEFT JOIN `:db`.acl_topology_relations acltr
                ON acltr.acl_topo_id = agtr.acl_topology_id
            INNER JOIN `:db`.topology
                ON topology.topology_id = acltr.topology_topology_id
            INNER JOIN `:db`.topology parent
                ON topology.topology_parent = parent.topology_page
            WHERE parent.topology_name = 'Dashboards'
                AND topology.topology_name IN ('Viewer','Administrator','Creator')
                AND acltr.access_right IS NOT NULL
                AND c.contact_id IN ({$bindTokenAsString})
                AND c.contact_admin = '0'
                GROUP BY c.contact_id
            SQL;
        $statement = $this->db->prepare($this->translateDbName($query));
        foreach ($bind as $token => $contactId) {
            $statement->bindValue($token, $contactId, \PDO::PARAM_INT);
        }

        $statement->execute();

        $dashboardContactRoles = [];
        foreach ($statement as $contactRole) {
            /** @var array{
             *     topologies: string,
             *     contact_name: string,
             *     contact_id: int,
             *     contact_email: string,
             *     acl_group_name: string|null
             * } $contactRole
             */
            $dashboardContactRoles[] = $this->createDashboardContactRole($contactRole);
        }

        return $dashboardContactRoles;
    }

    /**
     * @inheritDoc
     */
    public function findContactGroupsByRequestParameters(RequestParametersInterface $requestParameters): array
    {
        try {
            $sqlTranslator = new SqlRequestParametersTranslator($requestParameters);
            $sqlTranslator->getRequestParameters()->setConcordanceStrictMode(RequestParameters::CONCORDANCE_MODE_STRICT);
            $sqlTranslator->setConcordanceArray([
                'name' => 'cg.cg_name',
            ]);

            $query = <<<'SQL_WRAP'
                SELECT SQL_CALC_FOUND_ROWS
                    'Viewer' as topologies,
                    cg.cg_name,
                    cg.cg_id
                FROM `:db`.contactgroup cg
                SQL_WRAP;

            $searchRequest = $sqlTranslator->translateSearchParameterToSql();
            $query .= $searchRequest !== null ? ' WHERE ' . $searchRequest : '';
            $query .= ' GROUP BY cg.cg_id';

            $query .= $sqlTranslator->translatePaginationToSql();

            $statement = $this->db->prepare($this->translateDbName($query));
            $sqlTranslator->bindSearchValues($statement);
            $statement->execute();

            $result = $this->db->query('SELECT FOUND_ROWS()');
            if ($result !== false && ($total = $result->fetchColumn()) !== false) {
                $sqlTranslator->getRequestParameters()->setTotal((int) $total);
            }

            $dashboardContactGroupRoles = [];
            foreach ($statement as $contactGroupRole) {
                /** @var array{
                 *     topologies: string,
                 *     cg_name: string,
                 *     cg_id: int,
                 * } $contactGroupRole
                 */
                $dashboardContactGroupRoles[] = $this->createDashboardContactGroupRole($contactGroupRole);
            }

            return $dashboardContactGroupRoles;
        } catch (\Throwable $exception) {
            throw new RepositoryException(message: 'Error while searching for contact groups', previous: $exception);
        }
    }

    /**
     * @inheritDoc
     */
    public function findContactGroupsWithAccessRightByRequestParameters(RequestParametersInterface $requestParameters): array
    {
        $sqlTranslator = new SqlRequestParametersTranslator($requestParameters);
        $sqlTranslator->getRequestParameters()->setConcordanceStrictMode(RequestParameters::CONCORDANCE_MODE_STRICT);
        $sqlTranslator->setConcordanceArray([
            'name' => 'cg.cg_name',
        ]);

        $query = <<<'SQL_WRAP'
            SELECT SQL_CALC_FOUND_ROWS GROUP_CONCAT(topology.topology_name) as topologies, cg.cg_name, cg.cg_id
                FROM `:db`.contactgroup cg
                    LEFT JOIN `:db`.acl_group_contactgroups_relations gcgr
                        ON gcgr.cg_cg_id = cg.cg_id
                    LEFT JOIN `:db`.acl_group_topology_relations agtr
                        ON agtr.acl_group_id = gcgr.acl_group_id
                    LEFT JOIN `:db`.acl_topology_relations acltr
                        ON acltr.acl_topo_id = agtr.acl_topology_id
                    INNER JOIN `:db`.topology
                        ON topology.topology_id = acltr.topology_topology_id
                    INNER JOIN `:db`.topology parent
                        ON topology.topology_parent = parent.topology_page
            SQL_WRAP;

        $searchRequest = $sqlTranslator->translateSearchParameterToSql();
        $query .= $searchRequest !== null
            ? $searchRequest . ' AND '
            : ' WHERE ';

        $query .= <<<'SQL'
            parent.topology_name = 'Dashboards'
            AND topology.topology_name IN ('Viewer','Administrator','Creator')
            AND acltr.access_right IS NOT NULL
            GROUP BY cg.cg_id
            SQL;

        $query .= $sqlTranslator->translatePaginationToSql();

        $statement = $this->db->prepare($this->translateDbName($query));
        foreach ($sqlTranslator->getSearchValues() as $key => $data) {
            /**
             * @var int
             */
            $type = key($data);
            $value = $data[$type];
            $statement->bindValue($key, $value, $type);
        }
        $statement->execute();

        $result = $this->db->query('SELECT FOUND_ROWS()');
        if ($result !== false && ($total = $result->fetchColumn()) !== false) {
            $sqlTranslator->getRequestParameters()->setTotal((int) $total);
        }

        $dashboardContactGroupRoles = [];
        foreach ($statement as $contactGroupRole) {
            /** @var array{
             *     topologies: string,
             *     cg_name: string,
             *     cg_id: int,
             * } $contactGroupRole
             */
            $dashboardContactGroupRoles[] = $this->createDashboardContactGroupRole($contactGroupRole);
        }

        return $dashboardContactGroupRoles;
    }

    public function findContactGroupsWithAccessRightByContactGroupIds(array $contactGroupIds): array
    {
        $bind = [];
        foreach ($contactGroupIds as $key => $contactGroupId) {
            $bind[':contact_group' . $key] = $contactGroupId;
        }

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

        $bindTokenAsString = implode(', ', array_keys($bind));

        $query = <<<SQL
            SELECT SQL_CALC_FOUND_ROWS GROUP_CONCAT(topology.topology_name) as topologies, cg.cg_name, cg.cg_id
                FROM `:db`.contactgroup cg
                    LEFT JOIN `:db`.acl_group_contactgroups_relations gcgr
                        ON gcgr.cg_cg_id = cg.cg_id
                    LEFT JOIN `:db`.acl_group_topology_relations agtr
                        ON agtr.acl_group_id = gcgr.acl_group_id
                    LEFT JOIN `:db`.acl_topology_relations acltr
                        ON acltr.acl_topo_id = agtr.acl_topology_id
                    INNER JOIN `:db`.topology
                        ON topology.topology_id = acltr.topology_topology_id
                    INNER JOIN `:db`.topology parent
                        ON topology.topology_parent = parent.topology_page
                    WHERE parent.topology_name = 'Dashboards'
                        AND topology.topology_name IN ('Viewer','Administrator','Creator')
                        AND acltr.access_right IS NOT NULL
                        AND cg.cg_id IN ({$bindTokenAsString})
                    GROUP BY cg.cg_id
            SQL;

        $statement = $this->db->prepare($this->translateDbName($query));
        foreach ($bind as $token => $contactGroupId) {
            $statement->bindValue($token, $contactGroupId, \PDO::PARAM_INT);
        }
        $statement->execute();

        $dashboardContactGroupRoles = [];
        foreach ($statement as $contactGroupRole) {
            /** @var array{
             *     topologies: string,
             *     cg_name: string,
             *     cg_id: int,
             * } $contactGroupRole
             */
            $dashboardContactGroupRoles[] = $this->createDashboardContactGroupRole($contactGroupRole);
        }

        return $dashboardContactGroupRoles;
    }

    /**
     * @inheritDoc
     */
    public function findContactsWithAccessRightsByContactGroupsAndRequestParameters(
        array $contactGroups,
        RequestParametersInterface $requestParameters,
    ): array {
        try {
            if ($contactGroups === []) {
                return [];
            }

            $contactGroupIds = array_map(
                static fn (ContactGroup $contactGroup): int => $contactGroup->getId(),
                $contactGroups
            );

            $sqlTranslator = new SqlRequestParametersTranslator($requestParameters);
            $sqlTranslator->getRequestParameters()->setConcordanceStrictMode(
                RequestParameters::CONCORDANCE_MODE_STRICT
            );

            $sqlTranslator->setConcordanceArray([
                'name' => 'c.contact_name',
            ]);

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

            $query = <<<SQL
                    SELECT
                        GROUP_CONCAT(topology.topology_name) as topologies,
                        c.contact_name,
                        c.contact_id,
                        c.contact_email
                    FROM `:db`.contact c
                    LEFT JOIN `:db`.contactgroup_contact_relation cgcr
                        ON cgcr.contact_contact_id = c.contact_id
                    LEFT JOIN `:db`.acl_group_contactgroups_relations gcgr
                        ON gcgr.cg_cg_id = cgcr.contactgroup_cg_id
                    LEFT JOIN `:db`.acl_group_contacts_relations gcr
                        ON gcr.contact_contact_id = c.contact_id
                    LEFT JOIN `:db`.acl_group_topology_relations agtr
                        ON (agtr.acl_group_id = gcr.acl_group_id
                        OR agtr.acl_group_id = gcgr.acl_group_id)
                    LEFT JOIN `:db`.acl_topology_relations acltr
                        ON acltr.acl_topo_id = agtr.acl_topology_id
                    INNER JOIN `:db`.topology
                        ON topology.topology_id = acltr.topology_topology_id
                    INNER JOIN `:db`.topology parent
                        ON topology.topology_parent = parent.topology_page
                    WHERE
                        c.contact_oreon = '1'
                        AND parent.topology_name = 'Dashboards'
                        AND topology.topology_name IN ('Viewer','Administrator','Creator')
                        AND cgcr.contactgroup_cg_id IN ({$bindQuery})
                        AND acltr.access_right IS NOT NULL
                SQL;

            $searchRequest = $sqlTranslator->translateSearchParameterToSql();
            $query .= $searchRequest !== null ? ' AND ' . $searchRequest : '';

            $query .= ' GROUP BY c.contact_id';

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

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

            $sqlTranslator->bindSearchValues($statement);
            $statement->execute();

            $result = $this->db->query('SELECT FOUND_ROWS()');
            if ($result !== false && ($total = $result->fetchColumn()) !== false) {
                $sqlTranslator->getRequestParameters()->setTotal((int) $total);
            }

            $dashboardContactRoles = [];
            foreach ($statement as $contactRole) {
                /** @var array{
                 *     topologies: string,
                 *     contact_name: string,
                 *     contact_id: int,
                 *     contact_email: string
                 * } $contactRole
                 */
                $dashboardContactRoles[] = $this->createDashboardContactRole($contactRole);
            }

            return $dashboardContactRoles;
        } catch (\Throwable $exception) {
            throw new RepositoryException(
                message: "Error while retrieving contacts allowed to receive a dashboard share : {$exception->getMessage()}",
                previous: $exception,
            );
        }
    }

    /**
     * @inheritDoc
     */
    public function findContactsWithAccessRightByACLGroupsAndRequestParameters(
        RequestParametersInterface $requestParameters,
        int $contactId,
    ): array {
        $sqlTranslator = new SqlRequestParametersTranslator($requestParameters);
        $sqlTranslator->getRequestParameters()->setConcordanceStrictMode(
            RequestParameters::CONCORDANCE_MODE_STRICT
        );
        $sqlTranslator->setConcordanceArray([
            'name' => 'c.contact_name',
        ]);

        // Sharing scope resolved entirely from the current user's id (single bound :contactId,
        // no value/fragment concatenation): contacts reachable through the user's ACL access
        // groups (held directly or via the user's contact groups), plus contacts sharing one of
        // the user's contact groups. A dedicated COUNT query provides the unpaginated total
        // without materialising the paginated GROUP_CONCAT result set.
        $searchRequest = $sqlTranslator->translateSearchParameterToSql();

        $countQuery = <<<'SQL'
            SELECT COUNT(DISTINCT c.contact_id)
            FROM `:db`.contact c
                LEFT JOIN `:db`.contactgroup_contact_relation cgcr
                    ON cgcr.contact_contact_id = c.contact_id
                LEFT JOIN `:db`.acl_group_contactgroups_relations gcgr
                    ON gcgr.cg_cg_id = cgcr.contactgroup_cg_id
                LEFT JOIN `:db`.acl_group_contacts_relations gcr
                    ON gcr.contact_contact_id = c.contact_id
                LEFT JOIN `:db`.acl_group_topology_relations agtr
                    ON (agtr.acl_group_id = gcr.acl_group_id
                    OR agtr.acl_group_id = gcgr.acl_group_id)
                LEFT JOIN `:db`.acl_topology_relations acltr
                    ON acltr.acl_topo_id = agtr.acl_topology_id
                INNER JOIN `:db`.topology
                    ON topology.topology_id = acltr.topology_topology_id
                INNER JOIN `:db`.topology parent
                    ON topology.topology_parent = parent.topology_page
            SQL;
        $countQuery .= $searchRequest !== null ? $searchRequest . ' AND ' : ' WHERE ';
        $countQuery .= <<<'SQL'
            parent.topology_name = 'Dashboards'
                AND topology.topology_name IN ('Viewer','Administrator','Creator')
                AND (
                    gcr.acl_group_id IN (
                        SELECT acl_group_id FROM `:db`.acl_group_contacts_relations
                        WHERE contact_contact_id = :contactId1
                        UNION
                        SELECT user_acl_cg.acl_group_id FROM `:db`.acl_group_contactgroups_relations user_acl_cg
                            INNER JOIN `:db`.contactgroup_contact_relation user_cg
                                ON user_cg.contactgroup_cg_id = user_acl_cg.cg_cg_id
                            WHERE user_cg.contact_contact_id = :contactId2
                    )
                    OR gcgr.acl_group_id IN (
                        SELECT acl_group_id FROM `:db`.acl_group_contacts_relations
                        WHERE contact_contact_id = :contactId3
                        UNION
                        SELECT user_acl_cg2.acl_group_id FROM `:db`.acl_group_contactgroups_relations user_acl_cg2
                            INNER JOIN `:db`.contactgroup_contact_relation user_cg2
                                ON user_cg2.contactgroup_cg_id = user_acl_cg2.cg_cg_id
                            WHERE user_cg2.contact_contact_id = :contactId4
                    )
                    OR cgcr.contactgroup_cg_id IN (
                        SELECT contactgroup_cg_id FROM `:db`.contactgroup_contact_relation
                        WHERE contact_contact_id = :contactId5
                    )
                )
                AND acltr.access_right IS NOT NULL
                AND c.contact_oreon = '1'
            SQL;

        $query = <<<'SQL'
            SELECT
                GROUP_CONCAT(topology.topology_name) as topologies,
                c.contact_name,
                c.contact_id,
                c.contact_email
            FROM `:db`.contact c
                LEFT JOIN `:db`.contactgroup_contact_relation cgcr
                    ON cgcr.contact_contact_id = c.contact_id
                LEFT JOIN `:db`.acl_group_contactgroups_relations gcgr
                    ON gcgr.cg_cg_id = cgcr.contactgroup_cg_id
                LEFT JOIN `:db`.acl_group_contacts_relations gcr
                    ON gcr.contact_contact_id = c.contact_id
                LEFT JOIN `:db`.acl_group_topology_relations agtr
                    ON (agtr.acl_group_id = gcr.acl_group_id
                    OR agtr.acl_group_id = gcgr.acl_group_id)
                LEFT JOIN `:db`.acl_topology_relations acltr
                    ON acltr.acl_topo_id = agtr.acl_topology_id
                INNER JOIN `:db`.topology
                    ON topology.topology_id = acltr.topology_topology_id
                INNER JOIN `:db`.topology parent
                    ON topology.topology_parent = parent.topology_page
            SQL;
        $query .= $searchRequest !== null ? $searchRequest . ' AND ' : ' WHERE ';
        $query .= <<<'SQL'
            parent.topology_name = 'Dashboards'
                AND topology.topology_name IN ('Viewer','Administrator','Creator')
                AND (
                    gcr.acl_group_id IN (
                        SELECT acl_group_id FROM `:db`.acl_group_contacts_relations
                        WHERE contact_contact_id = :contactId1
                        UNION
                        SELECT user_acl_cg.acl_group_id FROM `:db`.acl_group_contactgroups_relations user_acl_cg
                            INNER JOIN `:db`.contactgroup_contact_relation user_cg
                                ON user_cg.contactgroup_cg_id = user_acl_cg.cg_cg_id
                            WHERE user_cg.contact_contact_id = :contactId2
                    )
                    OR gcgr.acl_group_id IN (
                        SELECT acl_group_id FROM `:db`.acl_group_contacts_relations
                        WHERE contact_contact_id = :contactId3
                        UNION
                        SELECT user_acl_cg2.acl_group_id FROM `:db`.acl_group_contactgroups_relations user_acl_cg2
                            INNER JOIN `:db`.contactgroup_contact_relation user_cg2
                                ON user_cg2.contactgroup_cg_id = user_acl_cg2.cg_cg_id
                            WHERE user_cg2.contact_contact_id = :contactId4
                    )
                    OR cgcr.contactgroup_cg_id IN (
                        SELECT contactgroup_cg_id FROM `:db`.contactgroup_contact_relation
                        WHERE contact_contact_id = :contactId5
                    )
                )
                AND acltr.access_right IS NOT NULL
                AND c.contact_oreon = '1'
            GROUP BY c.contact_id, c.contact_name
            SQL;
        $query .= $sqlTranslator->translatePaginationToSql();

        $queryParameters = SearchRequestParametersTransformer::reverseToQueryParameters(
            $sqlTranslator->getSearchValues()
        );
        foreach ([':contactId1', ':contactId2', ':contactId3', ':contactId4', ':contactId5'] as $token) {
            $queryParameters->add($token, QueryParameter::int($token, $contactId));
        }

        try {
            $sqlTranslator->getRequestParameters()->setTotal(
                (int) $this->db->fetchOne($this->translateDbName($countQuery), $queryParameters)
            );

            $dashboardContactRoles = [];
            foreach ($this->db->fetchAllAssociative($this->translateDbName($query), $queryParameters) as $contactRole) {
                /** @var array{
                 *     topologies: string,
                 *     contact_name: string,
                 *     contact_id: int,
                 *     contact_email: string
                 * } $contactRole
                 */
                $dashboardContactRoles[] = $this->createDashboardContactRole($contactRole);
            }

            return $dashboardContactRoles;
        } catch (\Throwable $exception) {
            throw new CoreRepositoryException(
                message: 'Error while searching contacts by ACL groups',
                context: ['contactId' => $contactId],
                previous: $exception
            );
        }
    }

    /**
     * @inheritDoc
     */
    public function findContactGroupsByUserAndRequestParameters(
        RequestParametersInterface $requestParameters,
        int $contactId,
    ): array {
        try {
            $sqlTranslator = new SqlRequestParametersTranslator($requestParameters);
            $sqlTranslator->getRequestParameters()->setConcordanceStrictMode(
                RequestParameters::CONCORDANCE_MODE_STRICT
            );
            $sqlTranslator->setConcordanceArray([
                'name' => 'cg.cg_name',
            ]);

            $query = <<<'SQL_WRAP'
                    SELECT SQL_CALC_FOUND_ROWS
                        'Viewer' as topologies,
                        cg.cg_name,
                        cg.cg_id
                    FROM `:db`.contactgroup cg
                    LEFT JOIN `:db`.contactgroup_contact_relation cgcr
                        ON cgcr.contactgroup_cg_id = cg.cg_id
                    WHERE cgcr.contact_contact_id = :contactId
                SQL_WRAP;

            $searchRequest = $sqlTranslator->translateSearchParameterToSql();
            $query .= $searchRequest !== null ? ' AND ' . $searchRequest : '';

            $query .= ' GROUP BY cg.cg_id';

            $statement = $this->db->prepare($this->translateDbName($query));
            $statement->bindValue(':contactId', $contactId, \PDO::PARAM_INT);
            $sqlTranslator->bindSearchValues($statement);
            $statement->execute();

            $result = $this->db->query('SELECT FOUND_ROWS()');
            if ($result !== false && ($total = $result->fetchColumn()) !== false) {
                $sqlTranslator->getRequestParameters()->setTotal((int) $total);
            }

            $dashboardContactGroupRoles = [];
            foreach ($statement as $contactGroupRole) {
                /** @var array{
                 *     topologies: string,
                 *     cg_name: string,
                 *     cg_id: int,
                 * } $contactGroupRole
                 */
                $dashboardContactGroupRoles[] = $this->createDashboardContactGroupRole($contactGroupRole);
            }

            return $dashboardContactGroupRoles;
        } catch (\Throwable $exception) {
            throw new RepositoryException(message: 'Error while searching contact groups by user', previous: $exception);
        }
    }

    /**
     * @inheritDoc
     */
    public function findContactGroupsWithAccessRightByACLGroupsAndRequestParameters(
        RequestParametersInterface $requestParameters,
        int $contactId,
    ): array {
        try {
            $sqlTranslator = new SqlRequestParametersTranslator($requestParameters);
            $sqlTranslator->getRequestParameters()->setConcordanceStrictMode(
                RequestParameters::CONCORDANCE_MODE_STRICT
            );
            $sqlTranslator->setConcordanceArray([
                'name' => 'cg.cg_name',
            ]);

            // Contact groups reachable through the current user's ACL access groups (held directly
            // or via the user's own contact groups), resolved from a single bound :contactId only
            // (no value/fragment concatenation). A dedicated COUNT query provides the unpaginated total.
            $searchRequest = $sqlTranslator->translateSearchParameterToSql();

            $countQuery = <<<'SQL'
                SELECT COUNT(DISTINCT cg.cg_id)
                FROM `:db`.contactgroup cg
                    LEFT JOIN `:db`.acl_group_contactgroups_relations gcgr
                        ON gcgr.cg_cg_id = cg.cg_id
                    LEFT JOIN `:db`.acl_group_topology_relations agtr
                        ON agtr.acl_group_id = gcgr.acl_group_id
                    LEFT JOIN `:db`.acl_topology_relations acltr
                        ON acltr.acl_topo_id = agtr.acl_topology_id
                    INNER JOIN `:db`.topology
                        ON topology.topology_id = acltr.topology_topology_id
                    INNER JOIN `:db`.topology parent
                        ON topology.topology_parent = parent.topology_page
                SQL;
            $countQuery .= $searchRequest !== null ? $searchRequest . ' AND ' : ' WHERE ';
            $countQuery .= <<<'SQL'
                parent.topology_name = 'Dashboards'
                    AND topology.topology_name IN ('Viewer','Administrator','Creator')
                    AND gcgr.acl_group_id IN (
                        SELECT acl_group_id FROM `:db`.acl_group_contacts_relations
                        WHERE contact_contact_id = :contactId1
                        UNION
                        SELECT user_acl_cg.acl_group_id FROM `:db`.acl_group_contactgroups_relations user_acl_cg
                            INNER JOIN `:db`.contactgroup_contact_relation user_cg
                                ON user_cg.contactgroup_cg_id = user_acl_cg.cg_cg_id
                            WHERE user_cg.contact_contact_id = :contactId2
                    )
                    AND acltr.access_right IS NOT NULL
                SQL;

            $query = <<<'SQL'
                SELECT GROUP_CONCAT(topology.topology_name) as topologies, cg.cg_name, cg.cg_id
                FROM `:db`.contactgroup cg
                    LEFT JOIN `:db`.acl_group_contactgroups_relations gcgr
                        ON gcgr.cg_cg_id = cg.cg_id
                    LEFT JOIN `:db`.acl_group_topology_relations agtr
                        ON agtr.acl_group_id = gcgr.acl_group_id
                    LEFT JOIN `:db`.acl_topology_relations acltr
                        ON acltr.acl_topo_id = agtr.acl_topology_id
                    INNER JOIN `:db`.topology
                        ON topology.topology_id = acltr.topology_topology_id
                    INNER JOIN `:db`.topology parent
                        ON topology.topology_parent = parent.topology_page
                SQL;
            $query .= $searchRequest !== null ? $searchRequest . ' AND ' : ' WHERE ';
            $query .= <<<'SQL'
                parent.topology_name = 'Dashboards'
                    AND topology.topology_name IN ('Viewer','Administrator','Creator')
                    AND gcgr.acl_group_id IN (
                        SELECT acl_group_id FROM `:db`.acl_group_contacts_relations
                        WHERE contact_contact_id = :contactId1
                        UNION
                        SELECT user_acl_cg.acl_group_id FROM `:db`.acl_group_contactgroups_relations user_acl_cg
                            INNER JOIN `:db`.contactgroup_contact_relation user_cg
                                ON user_cg.contactgroup_cg_id = user_acl_cg.cg_cg_id
                            WHERE user_cg.contact_contact_id = :contactId2
                    )
                    AND acltr.access_right IS NOT NULL
                GROUP BY cg.cg_id
                SQL;
            $query .= $sqlTranslator->translatePaginationToSql();

            $queryParameters = SearchRequestParametersTransformer::reverseToQueryParameters(
                $sqlTranslator->getSearchValues()
            );
            foreach ([':contactId1', ':contactId2'] as $token) {
                $queryParameters->add($token, QueryParameter::int($token, $contactId));
            }

            $sqlTranslator->getRequestParameters()->setTotal(
                (int) $this->db->fetchOne($this->translateDbName($countQuery), $queryParameters)
            );

            $dashboardContactGroupRoles = [];
            foreach ($this->db->fetchAllAssociative($this->translateDbName($query), $queryParameters) as $contactGroupRole) {
                /** @var array{
                 *     topologies: string,
                 *     cg_name: string,
                 *     cg_id: int,
                 * } $contactGroupRole
                 */
                $dashboardContactGroupRoles[] = $this->createDashboardContactGroupRole($contactGroupRole);
            }

            return $dashboardContactGroupRoles;
        } catch (\Exception $exception) {
            throw new CoreRepositoryException(
                message: 'Error while searching contact groups by ACL groups',
                context: ['contactId' => $contactId],
                previous: $exception
            );
        }
    }

    public function findContactGroupsWithAccessRightByUserAndRequestParameters(
        RequestParametersInterface $requestParameters,
        int $contactId,
    ): array {
        $sqlTranslator = new SqlRequestParametersTranslator($requestParameters);
        $sqlTranslator->getRequestParameters()->setConcordanceStrictMode(
            RequestParameters::CONCORDANCE_MODE_STRICT
        );
        $sqlTranslator->setConcordanceArray([
            'name' => 'cg.cg_name',
        ]);

        $query = <<<'SQL_WRAP'
            SELECT SQL_CALC_FOUND_ROWS GROUP_CONCAT(topology.topology_name) as topologies, cg.cg_name, cg.cg_id
            FROM `:db`.contactgroup cg
                LEFT JOIN `:db`.contactgroup_contact_relation cgcr
                    ON cgcr.contactgroup_cg_id = cg.cg_id
                LEFT JOIN `:db`.acl_group_contactgroups_relations gcgr
                    ON gcgr.cg_cg_id = cg.cg_id
                LEFT JOIN `:db`.acl_group_topology_relations agtr
                    ON agtr.acl_group_id = gcgr.acl_group_id
                LEFT JOIN `:db`.acl_topology_relations acltr
                    ON acltr.acl_topo_id = agtr.acl_topology_id
                INNER JOIN `:db`.topology
                    ON topology.topology_id = acltr.topology_topology_id
                INNER JOIN `:db`.topology parent
                    ON topology.topology_parent = parent.topology_page
            SQL_WRAP;

        $searchRequest = $sqlTranslator->translateSearchParameterToSql();
        $query .= $searchRequest !== null
            ? $searchRequest . ' AND '
            : ' WHERE ';

        $query .= <<<'SQL'
            parent.topology_name = 'Dashboards'
                AND topology.topology_name IN ('Viewer','Administrator','Creator')
                AND cgcr.contact_contact_id = :contactId
                AND acltr.access_right IS NOT NULL
            GROUP BY cg.cg_id
            SQL;

        $statement = $this->db->prepare($this->translateDbName($query));
        $statement->bindValue(':contactId', $contactId, \PDO::PARAM_INT);
        foreach ($sqlTranslator->getSearchValues() as $key => $data) {
            /**
             * @var int
             */
            $type = key($data);
            $value = $data[$type];
            $statement->bindValue($key, $value, $type);
        }
        $statement->execute();

        $result = $this->db->query('SELECT FOUND_ROWS()');
        if ($result !== false && ($total = $result->fetchColumn()) !== false) {
            $sqlTranslator->getRequestParameters()->setTotal((int) $total);
        }

        $dashboardContactGroupRoles = [];
        foreach ($statement as $contactGroupRole) {
            /** @var array{
             *     topologies: string,
             *     cg_name: string,
             *     cg_id: int,
             * } $contactGroupRole
             */
            $dashboardContactGroupRoles[] = $this->createDashboardContactGroupRole($contactGroupRole);
        }

        return $dashboardContactGroupRoles;
    }

    /**
     * @inheritDoc
     */
    public function existsAsEditor(int $dashboardId, ContactInterface $contact): bool
    {
        $query = <<<'SQL'
            SELECT 1 FROM `:db`.`dashboard` d
            LEFT JOIN  `:db`.`dashboard_contact_relation` dcr
            ON dcr.dashboard_id = d.id
            LEFT JOIN  `:db`.`dashboard_contactgroup_relation` dcgr
            ON dcgr.dashboard_id = d.id
            WHERE
                (dcgr.dashboard_id = :dashboardId
                AND dcgr.contactgroup_id IN (
                    SELECT contactgroup_cg_id FROM `:db`.contactgroup_contact_relation
                    WHERE contact_contact_id = :contactId
                )
                AND dcgr.role = 'editor')
            OR (
                dcr.dashboard_id = :dashboardId
                AND dcr.contact_id = :contactId
                AND dcr.role = 'editor')
            OR d.created_by = :contactId
            SQL;

        $statement = $this->db->prepare($this->translateDbName($query));
        $statement->bindValue(':dashboardId', $dashboardId, \PDO::PARAM_INT);
        $statement->bindValue(':contactId', $contact->getId(), \PDO::PARAM_INT);
        $statement->execute();

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

    /**
     * @param array{
     *      contact_name: string,
     *      contact_id: int,
     *      contact_email: string,
     *      contact_admin?: string,
     *      topologies?: string,
     *      acl_group_name?: string|null
     *  } $contactRole
     *
     * @throws \UnexpectedValueException
     *
     * @return DashboardContactRole
     */
    private function createDashboardContactRole(array $contactRole): DashboardContactRole
    {
        if (
            array_key_exists('acl_group_name', $contactRole)
            && $contactRole['acl_group_name'] === DashboardRights::AUTHORIZED_ACL_GROUP
        ) {
            $roles = [DashboardGlobalRole::Administrator];
        } else {
            $topologies = array_key_exists('topologies', $contactRole)
                ? explode(',', $contactRole['topologies'])
                : [];
            $roles = array_map(
                static fn (string $topology): DashboardGlobalRole => DashboardGlobalRoleConverter::fromString(
                    $topology
                ),
                $topologies
            );
        }

        return new DashboardContactRole(
            $contactRole['contact_id'],
            $contactRole['contact_name'],
            $contactRole['contact_email'],
            $roles
        );
    }

    /**
     * @param array{
     *      cg_name: string,
     *      cg_id: int,
     *      topologies: string
     *  } $contactRole
     *
     * @throws \UnexpectedValueException
     *
     * @return DashboardContactGroupRole
     */
    private function createDashboardContactGroupRole(array $contactRole): DashboardContactGroupRole
    {
        $topologies = explode(',', $contactRole['topologies']);
        $roles = array_map(
            static fn (string $topology): DashboardGlobalRole => DashboardGlobalRoleConverter::fromString(
                $topology
            ),
            $topologies
        );

        return new DashboardContactGroupRole(
            $contactRole['cg_id'],
            $contactRole['cg_name'],
            $roles
        );
    }

    /**
     * @param ContactInterface $contact
     * @param Dashboard ...$dashboards
     *
     * @throws RepositoryException
     * @throws \PDOException
     * @throws AssertionFailedException
     *
     * @return array<int, array<DashboardContactGroupShare>>
     */
    private function getContactGroupShares(ContactInterface $contact, Dashboard ...$dashboards): array
    {
        if ($dashboards === []) {
            return [];
        }

        $dashboardsById = [];
        foreach ($dashboards as $dashboard) {
            $dashboardsById[$dashboard->getId()] = $dashboard;
        }

        $select = <<<'SQL'
            SELECT
                cg.`cg_id`,
                cg.`cg_name`,
                dcgr.`dashboard_id`,
                dcgr.`role`
            FROM `:db`.`dashboard_contactgroup_relation` dcgr
            INNER JOIN `:db`.`contactgroup` cg ON cg.`cg_id`=dcgr.`contactgroup_id`
            INNER JOIN `:db`.`contactgroup_contact_relation` cgcr ON cg.`cg_id`=cgcr.`contactgroup_cg_id`
            WHERE
                cgcr.`contact_contact_id` = :contact_id
                AND dcgr.`dashboard_id` IN (:dashboard_ids)
            SQL;

        $concatenator = (new SqlConcatenator())
            ->defineSelect($select)
            ->storeBindValueMultiple(':dashboard_ids', array_keys($dashboardsById), \PDO::PARAM_INT)
            ->storeBindValue(':contact_id', $contact->getId(), \PDO::PARAM_INT);
        $statement = $this->db->prepare($this->translateDbName($concatenator->concatAll()));
        $concatenator->bindValuesToStatement($statement);
        $statement->setFetchMode(\PDO::FETCH_ASSOC);
        $statement->execute();

        // Retrieve data
        $shares = [];
        foreach ($statement as $result) {
            /** @var array{
             *     cg_id: int,
             *     cg_name: string,
             *     dashboard_id: int,
             *     role: string
             * } $result
             */
            $dashboardId = $result['dashboard_id'];
            if (! isset($dashboardsById[$dashboardId])) {
                continue;
            }

            $shares[$dashboardId][] = new DashboardContactGroupShare(
                $dashboardsById[$dashboardId],
                $result['cg_id'],
                $result['cg_name'],
                $this->stringToRole($result['role'])
            );
        }

        return $shares;
    }

    /**
     * @param ContactInterface $contact
     * @param Dashboard ...$dashboards
     *
     * @throws RepositoryException
     * @throws AssertionFailedException
     * @throws \PDOException
     *
     * @return array<int, DashboardContactShare>
     */
    private function getContactShares(ContactInterface $contact, Dashboard ...$dashboards): array
    {
        if ($dashboards === []) {
            return [];
        }

        $dashboardsById = [];
        foreach ($dashboards as $dashboard) {
            $dashboardsById[$dashboard->getId()] = $dashboard;
        }

        $select = <<<'SQL'
            SELECT
                dcr.`dashboard_id`,
                dcr.`role`
            FROM `:db`.`dashboard_contact_relation` dcr
            WHERE
                dcr.`contact_id` = :contact_id
                AND dcr.`dashboard_id` IN (:dashboard_ids)
            SQL;

        $concatenator = (new SqlConcatenator())
            ->defineSelect($select)
            ->storeBindValueMultiple(':dashboard_ids', array_keys($dashboardsById), \PDO::PARAM_INT)
            ->storeBindValue(':contact_id', $contact->getId(), \PDO::PARAM_INT);
        $statement = $this->db->prepare($this->translateDbName($concatenator->concatAll()));
        $concatenator->bindValuesToStatement($statement);
        $statement->setFetchMode(\PDO::FETCH_ASSOC);
        $statement->execute();

        // Retrieve data
        $shares = [];
        foreach ($statement as $result) {
            /** @var array{
             *     dashboard_id: int,
             *     role: string
             * } $result
             */
            $dashboardId = $result['dashboard_id'];

            $shares[$dashboardId] = new DashboardContactShare(
                $dashboardsById[$dashboardId],
                $contact->getId(),
                $contact->getName(),
                $contact->getEmail(),
                $this->stringToRole($result['role'])
            );
        }

        return $shares;
    }

    /**
     * We want to make the conversion between a role and its string table representation here.
     *
     * @param string $role
     *
     * @throws RepositoryException
     *
     * @return DashboardSharingRole
     */
    private function stringToRole(string $role): DashboardSharingRole
    {
        try {
            return DashboardSharingRoleConverter::fromString($role);
        } catch (\InvalidArgumentException $ex) {
            $this->error($ex->getMessage(), ['trace' => $ex->getTraceAsString()]);

            throw new RepositoryException($ex->getMessage(), $ex->getCode(), $ex);
        }
    }
}
