feat: implement isUserEligible() in PolicySpec with optional checker

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

Author: vitormattos

lib/Service/Policy/Model/PolicySpec.php

@@ -24,11 +24,14 @@ final class PolicySpec implements IPolicyDefinition {
 	private ?Closure $normalizer;
 	/** @var Closure(mixed, PolicyContext): void|null */
 	private ?Closure $validator;
+	/** @var Closure(PolicyContext): bool|null */
+	private ?Closure $eligibilityChecker;
 
 	/**
 	 * @param list<mixed>|Closure(PolicyContext): list<mixed> $allowedValues
 	 * @param Closure(mixed): mixed|null $normalizer
 	 * @param Closure(mixed, PolicyContext): void|null $validator
+	 * @param Closure(PolicyContext): bool|null $eligibilityChecker
 	 */
 	public function __construct(
 		private string $key,
@@ -40,10 +43,12 @@ public function __construct(
 		private ?string $userPreferenceKey = null,
 		private string $resolutionMode = self::RESOLUTION_MODE_RESOLVED,
 		private bool $supportsUserPreference = true,
+		?Closure $eligibilityChecker = null,
 	) {
 		$this->allowedValuesResolver = $allowedValues;
 		$this->normalizer = $normalizer;
 		$this->validator = $validator;
+		$this->eligibilityChecker = $eligibilityChecker;
 	}
 
 	#[\Override]
@@ -105,4 +110,13 @@ public function defaultSystemValue(): mixed {
 	public function supportsUserPreference(): bool {
 		return $this->supportsUserPreference;
 	}
+
+	#[\Override]
+	public function isUserEligible(PolicyContext $context): bool {
+		if ($this->eligibilityChecker !== null) {
+			return ($this->eligibilityChecker)($context);
+		}
+
+		return true;
+	}
 }