WMDE\BannerServer\UseCase\BannerSelection\BannerSelectionUseCase

Complexity

Total Complexity

8

Size/Duplication

Total Lines	46
Duplicated Lines	0 %

Test Coverage

Coverage

100%

Importance

Changes

0

3 Methods

Rating	Name	Duplication	Size	Complexity
A	isRatioLimited()	0	2	1
B	selectBanner()	0	32	6
A	__construct()	0	5	1

<?php

declare( strict_types = 1 );

namespace WMDE\BannerServer\UseCase\BannerSelection;

use WMDE\BannerServer\Entity\BannerSelection\Campaign;
use WMDE\BannerServer\Entity\BannerSelection\CampaignCollection;
use WMDE\BannerServer\Entity\BannerSelection\ImpressionThreshold;
use WMDE\BannerServer\Entity\BannerSelection\RandomIntegerGenerator;
use WMDE\BannerServer\Entity\Visitor;

/**
 * @license GPL-2.0-or-later
 */
class BannerSelectionUseCase {

	public function __construct(
		private readonly CampaignCollection $campaignCollection,
		private readonly ImpressionThreshold $impressionThreshold,
		private readonly RandomIntegerGenerator $rng
	) {
	}

	public function selectBanner( Visitor $visitor ): BannerSelectionData {
		$remainingCampaigns = $this->campaignCollection->filter(
			function ( Campaign $campaign ) use ( $visitor ): bool {
				return (
					$campaign->isInActiveDateRange( new \DateTime() ) &&
					$campaign->isInDisplayRange( $visitor->getDisplayWidth() ) &&
					!$this->impressionThreshold->isThresholdReached( $visitor->getTotalImpressionCount() ) &&
					!$visitor->inCategory( $campaign->getCategory() ) &&
					!$this->isRatioLimited( $campaign->getDisplayPercentage() )
				);
			}
		);

		if ( $remainingCampaigns->isEmpty() ) {
			return new EmptyBannerSelectionData( $visitor );
		}

		$selectedCampaign = $remainingCampaigns->getFirstCampaign();

		$visitorBucket = $selectedCampaign->selectBucket(
			$visitor->getBucketIdentifier()
		);

		return new ActiveBannerSelectionData(
			new Visitor(
				$visitor->getTotalImpressionCount() + 1,
				$visitorBucket->getIdentifier(),
				$visitor->getDisplayWidth(),
				...$visitor->getCategories()
			),
			$visitorBucket->getBanner( $visitor->getTotalImpressionCount() ),
			$selectedCampaign->getEnd()
		);
	}

	private function isRatioLimited( int $campaignDisplayPercent ): bool {
		return $this->rng->getRandomInteger( 1, 100 ) > $campaignDisplayPercent;
	}
}