<?php

declare(strict_types=1);

namespace Mironsoft\Loyalty\Model\Product\Type;

use Magento\Catalog\Model\Product\Type\Virtual;
use Magento\Framework\DataObject;

/**
 * Product type model for a purchasable "points package" - a non-shippable
 * product whose sole purpose is to credit a fixed number of loyalty points to
 * the buyer once the order is placed (see
 * Observer\CreditPurchasedPointsPackageOnOrderPlaced, chapter 76). Extends
 * Virtual to reuse its non-shippable behavior wholesale instead of
 * reimplementing it - it is the distinct type code below, not this
 * inheritance, that makes this a real, separately addressable product type
 * (see chapter 71 for why that distinction matters).
 */
class PointsPackage extends Virtual
{
    /**
     * Product type code, registered in etc/product_types.xml (chapter 72) and
     * referenced from CreditPurchasedPointsPackageOnOrderPlaced (chapter 76)
     * instead of a fragile boolean product attribute.
     */
    public const string TYPE_CODE = 'loyalty_points_package';

    /**
     * Rejects add-to-cart requests for a points package that has no positive
     * loyalty_points_package_amount configured (chapter 74) - a missing or
     * zero amount would silently credit nothing once the order is placed.
     * $product and $processMode stay untyped: the parent
     * AbstractType::_prepareProduct() declares no type hints for them
     * either, and PHP forbids narrowing (contravariance) on override.
     *
     * @param DataObject $buyRequest Add-to-cart request data
     * @param mixed $product Product being added to the cart
     * @param mixed $processMode One of AbstractType::PROCESS_MODE_* constants
     * @return array|string Array of prepared products, or an error string
     */
    protected function _prepareProduct(DataObject $buyRequest, $product, $processMode)
    {
        $pointsAmount = (int) $product->getData('loyalty_points_package_amount');
        if ($pointsAmount <= 0) {
            return __('This points package has no points amount configured.')->render();
        }

        return parent::_prepareProduct($buyRequest, $product, $processMode);
    }

    /**
     * Adds the package's point content to the generic "additional options"
     * array that Magento's own cart and order item templates already render
     * for every product type - no extra frontend template is needed for
     * this (see chapter 75). $product stays untyped for the same LSP reason
     * as _prepareProduct() above: AbstractType::getOrderOptions() declares
     * no type hint for it either.
     *
     * @param mixed $product Product the order item was created from
     * @return array<string, mixed>
     */
    public function getOrderOptions($product)
    {
        $optionArr = parent::getOrderOptions($product);

        $pointsAmount = (int) $product->getData('loyalty_points_package_amount');
        if ($pointsAmount > 0) {
            $optionArr['additional_options'][] = [
                'label' => __('Bonus points'),
                'value' => (string) $pointsAmount,
            ];
        }

        return $optionArr;
    }
}

<?php

declare(strict_types=1);

namespace Mironsoft\Loyalty\Model\Product\Type\PointsPackage;

/**
 * Price model for the loyalty_points_package product type. A thin, currently
 * behavior-preserving subclass of the generic Price model - its purpose is
 * not to change pricing today, but to give product_types.xml (chapter 72) a
 * dedicated priceModel class to point at, so a future change (e.g. bundled
 * package pricing tiers) never has to touch etc/product_types.xml again.
 */
class Price extends \Magento\Catalog\Model\Product\Type\Price
{
    /**
     * Explicitly documents that points packages use fixed tier prices, like
     * simple and virtual products - not the percentage-based tier prices
     * Configurable products use. Returns the same value the inherited
     * default already would; the override exists to make the decision
     * visible in code rather than leaving it an accident of inheritance
     * (see chapter 77 for why that matters once price rules enter the
     * picture).
     *
     * @return bool
     */
    public function isTierPriceFixed(): bool
    {
        return true;
    }
}