<?php

/**
 * Copyright 2024-2025 Simply.IN Sp. z o.o.
 *
 * NOTICE OF LICENSE
 *
 * Licensed under the EUPL-1.2 or later.
 * You may not use this work except in compliance with the Licence.
 *
 * Copy of the Licence is available at:
 * https://joinup.ec.europa.eu/software/page/eupl
 * It is bundled with this package in the file LICENSE.txt
 *
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the Licence is distributed on an as is basis,
 * without warranties or conditions of any kind, either express or implied.
 * Check the Licence for the specific language governing permissions
 * and limitations under the License.
 *
 * @author   Simply.IN Sp. z o.o.
 * @copyright 2024-2025 Simply.IN Sp. z o.o.
 * @license   https://joinup.ec.europa.eu/software/page/eupl
 */

declare(strict_types=1);

namespace SimplyIn\Front;

use Context;
use Controller;
use Module;
use Tools;

if (!defined('_PS_VERSION_')) {
    exit;
}

class OpcDetector
{
    public const OPC_CLASSIC = 'classic';
    public const OPC_THECHECKOUT = 'thecheckout';
    public const OPC_HUMMINGBIRD = 'hummingbird';

    private const CHECKOUT_CONTROLLERS = ['order', 'cart', 'orderconfirmation', 'authentication'];

    /**
     * The two pages that show an existing order's detail: the customer's own order page, and guest
     * order tracking. Both dispatch the same order-detail display hook with the same payload, which
     * is why one surface covers both audiences.
     *
     * @var list<string>
     */
    private const ORDER_DETAIL_CONTROLLERS = ['order-detail', 'guest-tracking'];

    private ?string $opc = null;

    public function isCheckoutController(): bool
    {
        $controller = Tools::getValue('controller');

        return is_string($controller) && in_array($controller, self::CHECKOUT_CONTROLLERS, true);
    }

    /**
     * Whether this request is on a page where payment may be re-offered against an existing order.
     *
     * Answered here rather than at each caller so that "which page is this" has ONE answer per
     * request: the asset registrar and the front-end payload both ask, and two predicates reading
     * two different sources would eventually disagree with each other.
     *
     * Read from the running controller's own php_self, which the controller sets itself. That is
     * deliberately a different source from isCheckoutController() above, which reads the request
     * parameter and can therefore be moved by appending a query string - tolerable for choosing
     * checkout assets, not for a page that renders a payment form.
     */
    public function isOrderDetailController(): bool
    {
        $controller = Context::getContext()->controller ?? null;
        $phpSelf = ($controller instanceof Controller) ? (string) $controller->php_self : '';

        return in_array($phpSelf, self::ORDER_DETAIL_CONTROLLERS, true);
    }

    public function detect(): string
    {
        if ($this->opc !== null) {
            return $this->opc;
        }

        // One path for every supported PS version. The old PS9 branch accepted an INACTIVE
        // TheCheckout as the checkout in use; requiring ->active is the correct test on both.
        $thecheckout = Module::getInstanceByName('thecheckout');
        if ($thecheckout && $thecheckout->active) {
            return $this->opc = self::OPC_THECHECKOUT;
        }

        if ((Context::getContext()->shop->theme_name ?? '') === 'hummingbird') {
            return $this->opc = self::OPC_HUMMINGBIRD;
        }

        return $this->opc = self::OPC_CLASSIC;
    }
}
