<?php

/**
 * @package     Joomla.Plugin
 * @subpackage  Webservices.media
 *
 * @copyright   (C) 2021 Open Source Matters, Inc. <https://www.joomla.org>
 * @license     GNU General Public License version 2 or later; see LICENSE.txt
 */

namespace Joomla\Plugin\WebServices\Media\Extension;

use Joomla\CMS\Plugin\CMSPlugin;
use Joomla\CMS\Router\ApiRouter;
use Joomla\Router\Route;

// phpcs:disable PSR1.Files.SideEffects
\defined('_JEXEC') or die;
// phpcs:enable PSR1.Files.SideEffects

/**
 * Web Services adapter for com_media.
 *
 * @since  4.1.0
 */
final class Media extends CMSPlugin
{
    /**
     * Registers com_media's API's routes in the application.
     *
     * @param   ApiRouter  &$router  The API Routing object
     *
     * @return  void
     *
     * @since   4.1.0
     */
    public function onBeforeApiRoute(&$router): void
    {
        $this->createAdapterReadRoutes(
            $router,
            'v1/media/adapters',
            'adapters',
            ['component' => 'com_media']
        );
        $this->createMediaCRUDRoutes(
            $router,
            'v1/media/files',
            'media',
            ['component' => 'com_media']
        );
    }

    /**
     * Creates adapter read routes.
     *
     * @param   ApiRouter  &$router     The API Routing object
     * @param   string     $baseName    The base name of the component.
     * @param   string     $controller  The name of the controller that contains CRUD functions.
     * @param   array      $defaults    An array of default values that are used when the URL is matched.
     * @param   bool       $publicGets  Allow the public to make GET requests.
     *
     * @return  void
     *
     * @since   4.1.0
     */
    private function createAdapterReadRoutes(&$router, $baseName, $controller, $defaults = [], $publicGets = false): void
    {
        $getDefaults = array_merge(['public' => $publicGets], $defaults);

        $routes = [
            new Route(['GET'], $baseName, $controller . '.displayList', [], $getDefaults),
            new Route(['GET'], $baseName . '/:id', $controller . '.displayItem', [], $getDefaults),
        ];

        $router->addRoutes($routes);
    }

    /**
     * Creates media CRUD routes.
     *
     * @param   ApiRouter  &$router     The API Routing object
     * @param   string     $baseName    The base name of the component.
     * @param   string     $controller  The name of the controller that contains CRUD functions.
     * @param   array      $defaults    An array of default values that are used when the URL is matched.
     * @param   bool       $publicGets  Allow the public to make GET requests.
     *
     * @return  void
     *
     * @since   4.1.0
     */
    private function createMediaCRUDRoutes(&$router, $baseName, $controller, $defaults = [], $publicGets = false): void
    {
        $getDefaults = array_merge(['public' => $publicGets], $defaults);

        $routes = [
            new Route(['GET'], $baseName, $controller . '.displayList', [], $getDefaults),
            // When the path ends with a backslash, then list the items
            new Route(['GET'], $baseName . '/:path/', $controller . '.displayList', ['path' => '.*\/'], $getDefaults),
            new Route(['GET'], $baseName . '/:path', $controller . '.displayItem', ['path' => '.*'], $getDefaults),
            new Route(['POST'], $baseName, $controller . '.add', [], $defaults),
            new Route(['PATCH'], $baseName . '/:path', $controller . '.edit', ['path' => '.*'], $defaults),
            new Route(['DELETE'], $baseName . '/:path', $controller . '.delete', ['path' => '.*'], $defaults),
        ];

        $router->addRoutes($routes);
    }
}
