From 0c96b2aed127c5f9f50a47bdfd08e6250d5e17c4 Mon Sep 17 00:00:00 2001
From: Daniel Subiabre <daniel.subiabre@platoniq.net>
Date: Mon, 28 Apr 2025 14:16:38 +0200
Subject: [PATCH] Expose match rules as api resources

---
 .../Matchfunding/RuleApiResource.php          | 28 ++++++++++
 src/Matchfunding/Rule/RuleInterface.php       |  5 ++
 src/State/Matchfunding/RuleStateProvider.php  | 56 +++++++++++++++++++
 3 files changed, 89 insertions(+)
 create mode 100644 src/ApiResource/Matchfunding/RuleApiResource.php
 create mode 100644 src/State/Matchfunding/RuleStateProvider.php

diff --git a/src/ApiResource/Matchfunding/RuleApiResource.php b/src/ApiResource/Matchfunding/RuleApiResource.php
new file mode 100644
index 0000000..009613b
--- /dev/null
+++ b/src/ApiResource/Matchfunding/RuleApiResource.php
@@ -0,0 +1,28 @@
+<?php
+
+namespace App\ApiResource\Matchfunding;
+
+use ApiPlatform\Metadata as API;
+use App\State\Matchfunding\RuleStateProvider;
+
+/**
+ * A MatchRule is a predefined code implementation for validating
+ * that a match making condition is met when there is a Charge to be matched.
+ */
+#[API\ApiResource(
+    shortName: 'MatchRule',
+    provider: RuleStateProvider::class
+)]
+#[API\GetCollection()]
+#[API\Get()]
+class RuleApiResource
+{
+    #[API\ApiProperty(identifier: true, writable: false)]
+    public string $name;
+
+    /**
+     * A plain-text description about what the rules validates for.
+     */
+    #[API\ApiProperty(writable: false)]
+    public string $description;
+}
diff --git a/src/Matchfunding/Rule/RuleInterface.php b/src/Matchfunding/Rule/RuleInterface.php
index 1d5202a..7ef85fc 100644
--- a/src/Matchfunding/Rule/RuleInterface.php
+++ b/src/Matchfunding/Rule/RuleInterface.php
@@ -7,6 +7,11 @@ use App\Entity\Project\Project;
 
 interface RuleInterface
 {
+    /**
+     * A plain-text description about what the rules validates for.
+     */
+    public static function getDescription(): string;
+
     /**
      * Do necessary checks to determine if Charge and Project comply with this rule.
      * 
diff --git a/src/State/Matchfunding/RuleStateProvider.php b/src/State/Matchfunding/RuleStateProvider.php
new file mode 100644
index 0000000..188c5e4
--- /dev/null
+++ b/src/State/Matchfunding/RuleStateProvider.php
@@ -0,0 +1,56 @@
+<?php
+
+namespace App\State\Matchfunding;
+
+use ApiPlatform\Metadata\Operation;
+use ApiPlatform\State\ProviderInterface;
+use App\ApiResource\Matchfunding\RuleApiResource;
+use App\Matchfunding\Rule\RuleInterface;
+use App\Matchfunding\Rule\RuleLocator;
+use Symfony\Component\VarExporter\Exception\ClassNotFoundException;
+
+class RuleStateProvider implements ProviderInterface
+{
+    public function __construct(
+        private RuleLocator $ruleLocator,
+    ) {}
+
+    public function provide(Operation $operation, array $uriVariables = [], array $context = []): object|array|null
+    {
+        if (\array_key_exists('name', $uriVariables)) {
+            try {
+                $rule = $this->ruleLocator->getOne(\sprintf(
+                    'App\\Matchfunding\\Rule\\%s',
+                    $uriVariables['name']
+                ));
+
+                return $this->getApiResource($rule);
+            } catch (ClassNotFoundException $e) {
+                return null;
+            }
+        }
+
+        $strategies = $this->ruleLocator->getAll();
+
+        $resources = [];
+        foreach ($strategies as $rule) {
+            $resources[] = $this->getApiResource($rule);
+        }
+
+        return $resources;
+    }
+
+    private function getApiResource(RuleInterface $rule): RuleApiResource
+    {
+        $resource = new RuleApiResource();
+        $resource->name = self::getName($rule::class);
+        $resource->description = $rule::getDescription();
+
+        return $resource;
+    }
+
+    private static function getName(string $class): string
+    {
+        return \array_slice(\explode('\\', $class), -1, 1)[0];
+    }
+}