SuiteCRM-Core/public/legacy/include/portability/RouteConverter.php

<?php
/**
 * SuiteCRM is a customer relationship management program developed by SalesAgility Ltd.
 * Copyright (C) 2021 SalesAgility Ltd.
 *
 * This program is free software; you can redistribute it and/or modify it under
 * the terms of the GNU Affero General Public License version 3 as published by the
 * Free Software Foundation with the addition of the following permission added
 * to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED WORK
 * IN WHICH THE COPYRIGHT IS OWNED BY SALESAGILITY, SALESAGILITY DISCLAIMS THE
 * WARRANTY OF NON INFRINGEMENT OF THIRD PARTY RIGHTS.
 *
 * This program is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
 * FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
 * details.
 *
 * You should have received a copy of the GNU Affero General Public License
 * along with this program.  If not, see http://www.gnu.org/licenses.
 *
 * In accordance with Section 7(b) of the GNU Affero General Public License
 * version 3, these Appropriate Legal Notices must retain the display of the
 * "Supercharged by SuiteCRM" logo. If the display of the logos is not reasonably
 * feasible for technical reasons, the Appropriate Legal Notices must display
 * the words "Supercharged by SuiteCRM".
 */

require_once 'include/portability/ModuleNameMapper.php';
require_once 'include/portability/ActionNameMapper.php';

/**
 * Class RouteConverter
 *
 * @package App\Legacy
 */
class RouteConverter
{
    /**
     * @var ModuleNameMapper
     */
    protected $moduleNameMapper;

    /**
     * @var ActionNameMapper
     */
    private $actionNameMapper;

    /**
     * RouteConverter constructor.
     */
    public function __construct()
    {
        $this->moduleNameMapper = new ModuleNameMapper();
        $this->actionNameMapper = new ActionNameMapper();
    }

    /**
     * Convert given $request route
     *
     * @param string|null $module
     * @param string|null $action
     * @param string|null $record
     * @param array|null $queryParams
     * @return string
     */
    public function convert(?string $module, ?string $action, ?string $record, ?array $queryParams): string
    {
        if (empty($module)) {
            return '';
        }

        $route = $this->buildRoute($module, $action, $record);

        $queryString = $this->buildQueryString($queryParams, ['module', 'action', 'record']);

        if (!empty($queryString)) {
            $queryString = '?' . $queryString;
        }

        return $route . $queryString;
    }

    /**
     * Convert given $uri route and point to Suite 8 path
     *
     * @param string $uri
     * @return string
     */
    public function generateUiLink(string $uri): string
    {
        $link = $this->convertUri($uri);

        return str_replace('./', '../', $link);
    }

    /**
     * Convert given $uri route
     *
     * @param string $uri
     * @return string
     */
    public function convertUri(string $uri): string
    {
        $query = parse_url($uri, PHP_URL_QUERY);

        if (empty($query)) {
            throw new InvalidArgumentException('No module defined');
        }
        parse_str($query, $data);

        $defaults = [
            'module' => '',
            'action' => '',
            'record' => ''
        ];

        ['module' => $module, 'action' => $action, 'record' => $record] = array_merge($defaults, $data);

        return $this->convert($module, $action, $record, $data);
    }

    /**
     * Convert legacy entryPoint URL to modern /ep/ format
     *
     * @param string $uri Legacy URL with entryPoint parameter (e.g., "index.php?entryPoint=download&id=123")
     * @return string Modern URL format (e.g., "./ep/download?id=123")
     */
    public function convertEntryPointUri(string $uri): string
    {
        $query = parse_url($uri, PHP_URL_QUERY);

        if (empty($query)) {
            return $uri;
        }

        parse_str($query, $data);

        $entryPoint = $data['entryPoint'] ?? '';
        if (empty($entryPoint)) {
            return $uri;
        }

        unset($data['entryPoint']);

        $convertedUri = "./ep/$entryPoint";

        if (!empty($data)) {
            $httpQuery = http_build_query($data, '', '&', PHP_QUERY_RFC3986);
            $convertedUri .= "?$httpQuery";
        }

        return $convertedUri;
    }

    /**
     * Convert legacy entryPoint URL to Suite 8 UI link format
     *
     * @param string $uri Legacy URL with entryPoint parameter (e.g., "index.php?entryPoint=download&id=123")
     * @return string Suite 8 URL format (e.g., "../ep/download?id=123")
     */
    public function generateUiLinkForEntryPoint(string $uri): string
    {
        $link = $this->convertEntryPointUri($uri);

        return str_replace('./', '../', $link);
    }

    /**
     * Check if the given $request route is a Legacy route
     *
     * @param string $uri
     * @return bool
     */
    public function isLegacyRoute(string $uri): bool
    {

        if (strpos($uri, './index.php') < 0) {
            return false;
        }

        $query = parse_url($uri, PHP_URL_QUERY);

        if (empty($query)) {
            return false;
        }
        parse_str($query, $data);

        if (empty($data['module'])) {
            return false;
        }

        return true;
    }


    /**
     * Build Suite 8 route
     *
     * @param string $module
     * @param string|null $action
     * @param string|null $record
     * @return string
     */
    protected function buildRoute(?string $module, ?string $action, ?string $record): string
    {
        $moduleName = $this->mapModule($module);
        $route = "./#/$moduleName";

        if (!empty($action)) {
            $actionName = $this->mapAction($action);
            $route .= "/$actionName";
        }

        if (!empty($record)) {
            $route .= "/$record";
        }

        return $route;
    }

    /**
     * Map action name
     * @param string $action
     * @return string
     */
    protected function mapAction(string $action): string
    {
        return $this->actionNameMapper->toFrontend($action);
    }

    /**
     * Map module name
     * @param string $module
     * @return string
     */
    protected function mapModule(string $module): string
    {
        return $this->moduleNameMapper->toFrontEnd($module);
    }

    /**
     * Build query string
     * @param array $queryParams
     * @param array $exclude
     * @return string
     */
    public function buildQueryString(array $queryParams, array $exclude): string
    {
        $validParams = $this->excludeParams($queryParams, $exclude);

        if (empty($exclude)) {
            return '';
        }

        return http_build_query($validParams, '', '&', PHP_QUERY_RFC3986);
    }

    /**
     * Build new array where list of query params are excluded
     * @param array $queryParams
     * @param array $exclude
     * @return array
     */
    public function excludeParams(array $queryParams, array $exclude): array
    {
        $validParams = [];

        foreach ($queryParams as $name => $value) {
            if (in_array($name, $exclude, true)) {
                continue;
            }
            $validParams[$name] = $value;
        }

        return $validParams;
    }
}