<?php
/***********************************************************************************
 * The contents of this file are subject to the Extension License Agreement
 * ("Agreement") which can be viewed at
 * https://www.espocrm.com/extension-license-agreement/.
 * By copying, installing downloading, or using this file, You have unconditionally
 * agreed to the terms and conditions of the Agreement, and You may not use this
 * file except in compliance with the Agreement. Under the terms of the Agreement,
 * You shall not license, sublicense, sell, resell, rent, lease, lend, distribute,
 * redistribute, market, publish, commercialize, or otherwise transfer rights or
 * usage to the software or any modified version or derivative work of the software
 * created by or for you.
 *
 * Copyright (C) 2015-2026 EspoCRM, Inc.
 *
 * License ID: 19bc86a68a7bb01f458cb391d43a9212
 ************************************************************************************/

namespace Espo\Modules\Advanced\Tools\Report\ListType;

use Espo\Core\Exceptions\BadRequest;
use Espo\Core\Exceptions\Forbidden;
use Espo\Core\Select\SearchParams;
use Espo\Core\Select\Where\Item as WhereItem;
use Espo\Core\Utils\FieldUtil;
use Espo\Entities\User;
use Espo\Modules\Advanced\Tools\Report\GridType\Data as Data;
use Espo\Modules\Advanced\Tools\Report\SelectHelper;
use Espo\ORM\Name\Attribute;
use Espo\ORM\Query\Select;

class SubListQueryPreparator
{
    public function __construct(
        private SubReportQueryPreparator $subReportQueryPreparator,
        private SelectHelper $selectHelper,
        private FieldUtil $fieldUtil,
    ) {}

    /**
     * @param ?scalar $groupValue
     * @param string[] $columnList
     * @param string[] $realColumnList
     *
     * @throws Forbidden
     * @throws BadRequest
     */
    public function prepare(
        Data $data,
        $groupValue,
        array $columnList,
        array $realColumnList,
        ?WhereItem $where,
        ?User $user,
    ): Select {

        $selectAttributes = [Attribute::ID];

        // Needed for dependent attributes.
        foreach ($data->getColumns() as $column) {
            if (str_contains($column, '.') || str_contains($column, ':')) {
                continue;
            }

            array_push(
                $selectAttributes,
                ...$this->fieldUtil->getAttributeList($data->getEntityType(), $column)
            );
        }

        $searchParams = SearchParams::create()->withSelect($selectAttributes);

        if ($where) {
            $searchParams = $searchParams->withWhere($where);
        }

        $queryBuilder = $this->subReportQueryPreparator->prepare(
            data: $data,
            searchParams: $searchParams,
            subReportParams: new SubReportParams(0, $groupValue),
            user: $user,
        );

        $this->selectHelper->handleColumns($realColumnList, $queryBuilder);

        $newOrderBy = [];

        foreach ($data->getOrderBy() as $orderByItem) {
            $orderByColumn = explode(':', $orderByItem)[1] ?? null;

            if (in_array($orderByColumn, $columnList)) {
                $newOrderBy[] = $orderByItem;
            }
        }

        if ($newOrderBy !== []) {
            $queryBuilder->order([]);
        }

        $this->selectHelper->handleOrderBy($newOrderBy, $queryBuilder);

        return $queryBuilder->build();
    }
}
