<?php

declare(strict_types=1);

namespace ErpSync\CorporateRewards\Api;

/**
 * Vendor-provided contract for resolving a company's ERP-driven pricing
 * multiplier. Part of a licensed third-party extension, not this project's code.
 */
interface MultiplierResolverInterface
{
    /**
     * @param int $companyId Company entity ID.
     * @return float
     */
    public function resolveForCompany(int $companyId): float;
}

<?php

declare(strict_types=1);

namespace ErpSync\CorporateRewards\Model;

use ErpSync\CorporateRewards\Api\MultiplierResolverInterface;

/**
 * Default implementation, shipped by the vendor. resolveForCompany() is
 * declared final on purpose - the vendor wants every shop's ERP multiplier
 * to always come straight from their sync service, with no local drift.
 */
class MultiplierResolver implements MultiplierResolverInterface
{
    // ... constructor with the vendor's own ERP client dependency ...

    /**
     * @param int $companyId Company entity ID.
     * @return float
     */
    final public function resolveForCompany(int $companyId): float
    {
        // ... calls the external ERP system, falls back to 1.0 on error ...
    }
}

<?php

declare(strict_types=1);

namespace Mironsoft\Loyalty\Model\Erp;

use ErpSync\CorporateRewards\Api\MultiplierResolverInterface;
use ErpSync\CorporateRewards\Model\MultiplierResolver;
use Magento\Company\Api\CompanyRepositoryInterface;
use Mironsoft\Loyalty\Model\Source\LoyaltyTier;

/**
 * Replaces the vendor's MultiplierResolver via a di.xml preference. Composes
 * - rather than extends - the vendor's final-method implementation, so its ERP
 * logic stays intact while a project-specific floor value is layered on top.
 */
class CompanyMultiplierPreference implements MultiplierResolverInterface
{
    /**
     * @var array<string, float>
     */
    private const TIER_FLOOR_MULTIPLIERS = [
        LoyaltyTier::TIER_BRONZE => 1.0,
        LoyaltyTier::TIER_SILVER => 1.2,
        LoyaltyTier::TIER_GOLD => 1.5,
    ];

    /**
     * @param MultiplierResolver $originalResolver The vendor's own final-method implementation, composed rather than extended.
     * @param CompanyRepositoryInterface $companyRepository Loads the company to read loyalty_tier_override (chapter 22).
     */
    public function __construct(
        private readonly MultiplierResolver $originalResolver,
        private readonly CompanyRepositoryInterface $companyRepository,
    ) {
    }

    /**
     * Resolves the ERP multiplier, raised to the project's tier floor if needed.
     *
     * @param int $companyId Company entity ID.
     * @return float
     */
    public function resolveForCompany(int $companyId): float
    {
        $erpMultiplier = $this->originalResolver->resolveForCompany($companyId);

        $company = $this->companyRepository->get($companyId);
        // @phpstan-ignore-next-line CompanyInterface::getData() is not on the interface but exists on the model
        $tierOverride = (string) $company->getData('loyalty_tier_override');
        $floor = self::TIER_FLOOR_MULTIPLIERS[$tierOverride] ?? 0.0;

        return max($erpMultiplier, $floor);
    }
}

<preference for="ErpSync\CorporateRewards\Api\MultiplierResolverInterface"
            type="Mironsoft\Loyalty\Model\Erp\CompanyMultiplierPreference"/>