<?php

declare(strict_types=1);

namespace Mironsoft\Loyalty\Controller;

use Magento\Framework\App\Action\Forward;
use Magento\Framework\App\ActionFactory;
use Magento\Framework\App\ActionInterface;
use Magento\Framework\App\Request\Http as HttpRequest;
use Magento\Framework\App\RequestInterface;
use Magento\Framework\App\RouterInterface;
use Magento\Store\Model\StoreManagerInterface;
use Mironsoft\Loyalty\Model\Config\LoyaltyConfig;
use Mironsoft\Loyalty\Model\ResourceModel\Reward\CollectionFactory as RewardCollectionFactory;

/**
 * Custom frontend router resolving the pretty, store-configurable loyalty URLs:
 *
 *   /rewards                    -> Controller\Catalog\Index (reward catalog)
 *   /rewards/history             -> Controller\History\Index (points history)
 *   /rewards/{reward-identifier} -> Controller\Catalog\View (reward detail)
 *
 * Modelled after this project's own Mironsoft\Tutorial\Controller\Router: existence
 * IS checked here (the reward lookup below), because an unconditional match combined
 * with Action\Forward re-entering the full router chain would otherwise risk bouncing
 * an unresolvable path back and forth until Magento's 100-iteration router safety cap
 * is hit. Returning null lets Magento's normal 404 handling take over exactly once.
 */
class Router implements RouterInterface
{
    /**
     * @param ActionFactory $actionFactory Instantiates the Forward action that re-dispatches to the resolved controller.
     * @param LoyaltyConfig $loyaltyConfig Provides the store-configurable front name and history slug.
     * @param RewardCollectionFactory $rewardCollectionFactory Confirms a reward identifier exists before claiming the route.
     * @param StoreManagerInterface $storeManager Provides the current store ID for the config and existence lookups.
     */
    public function __construct(
        private readonly ActionFactory $actionFactory,
        private readonly LoyaltyConfig $loyaltyConfig,
        private readonly RewardCollectionFactory $rewardCollectionFactory,
        private readonly StoreManagerInterface $storeManager,
    ) {
    }

    /**
     * Attempts to resolve the current request to a loyalty controller action.
     *
     * @param RequestInterface $request Current HTTP request.
     * @return ActionInterface|null Null lets the next router in the chain try (and,
     *   for an unresolvable path, ultimately Magento's normal 404 handling).
     */
    public function match(RequestInterface $request): ?ActionInterface
    {
        if (!$this->loyaltyConfig->isEnabled()) {
            return null;
        }

        $storeId = (int) $this->storeManager->getStore()->getId();
        $frontName = $this->loyaltyConfig->getFrontName($storeId);

        /** @var HttpRequest $request */
        $path = trim((string) $request->getPathInfo(), '/');

        if ($path !== $frontName && !str_starts_with($path, $frontName . '/')) {
            return null;
        }

        $rest = trim(substr($path, strlen($frontName)), '/');
        $segments = $rest === '' ? [] : explode('/', $rest);

        if (count($segments) === 0) {
            return $this->forwardTo($request, 'catalog', 'index', []);
        }

        if (count($segments) > 1) {
            return null;
        }

        if ($segments[0] === $this->loyaltyConfig->getHistorySlug($storeId)) {
            return $this->forwardTo($request, 'history', 'index', []);
        }

        $reward = $this->rewardCollectionFactory->create()
            ->addActiveFilter()
            ->addFieldToFilter('identifier', ['eq' => $segments[0]])
            ->getFirstItem();

        if (!$reward->getId()) {
            return null;
        }

        return $this->forwardTo($request, 'catalog', 'view', ['reward_identifier' => $segments[0]]);
    }

    /**
     * Sets the resolved module/controller/action/params on the request and returns a
     * Forward action to re-dispatch through the standard controller resolution mechanism.
     *
     * @param RequestInterface $request Current HTTP request, mutated in place.
     * @param string $controllerName Target controller directory (snake_case maps to StudlyCase).
     * @param string $actionName Target action file (snake_case maps to StudlyCase).
     * @param array<string, string> $params Route parameters made available via getParam().
     * @return ActionInterface
     */
    private function forwardTo(RequestInterface $request, string $controllerName, string $actionName, array $params): ActionInterface
    {
        /** @var HttpRequest $request */
        $request->setModuleName('mironsoft_loyalty')
            ->setControllerName($controllerName)
            ->setActionName($actionName)
            ->setParams($params);

        return $this->actionFactory->create(Forward::class);
    }
}

<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:noNamespaceSchemaLocation="urn:magento:framework:ObjectManager/etc/config.xsd">
    <type name="Magento\Framework\App\RouterList">
        <arguments>
            <argument name="routerList" xsi:type="array">
                <!-- sortOrder=40: runs before Magento_Cms's router (60), so a
                     reward slug never gets mistaken for a CMS page URL, and after
                     the core "standard" router (20) so the internal
                     /mironsoft_loyalty/... path from chapter 45 still resolves
                     directly if it's ever hit outright. -->
                <item name="mironsoft_loyalty" xsi:type="array">
                    <item name="class" xsi:type="string">Mironsoft\Loyalty\Controller\Router</item>
                    <item name="disable" xsi:type="boolean">false</item>
                    <item name="sortOrder" xsi:type="string">40</item>
                </item>
            </argument>
        </arguments>
    </type>
</config>