[FEATURE] Allow multiple partner types (#698)

Draft as this needs to be tested with any usages.

---
- To see the specific tasks where the Asana app for GitHub is being
used, see below:
  - https://app.asana.com/0/0/1211138782444277

Author: buchmarv

src/Entity/Company.php

@@ -66,7 +66,11 @@ class Company implements \JsonSerializable
      */
     private array $subscriptions = [];
     private ?Address $headquarter = null;
-    private ?Subscription $partnerProgram = null;
+
+    /**
+     * @var Subscription[]
+     */
+    private array $partnerPrograms = [];
     private ?Subscription $membership = null;
     private ?string $domain = null;
     private ?string $backlink = null;
@@ -427,17 +431,32 @@ public function addSubscription(Subscription $subscription): self
         return $this;
     }
 
-    public function getPartnerProgram(): ?Subscription
+    /**
+     * @return Subscription[]
+     */
+    public function getPartnerPrograms(): array
+    {
+        return $this->partnerPrograms;
+    }
+
+    /**
+     * @param Subscription[] $partnerPrograms
+     *
+     * @return $this
+     */
+    public function setPartnerPrograms(array $partnerPrograms): self
     {
-        return $this->partnerProgram;
+        $this->partnerPrograms = $partnerPrograms;
+
+        return $this;
     }
 
     /**
      * @return $this
      */
-    public function setPartnerProgram(?Subscription $partnerProgram): self
+    public function addPartnerProgram(Subscription $partnerProgram): self
     {
-        $this->partnerProgram = $partnerProgram;
+        $this->partnerPrograms[] = $partnerProgram;
 
         return $this;
     }

src/Enum/PartnerProgramType.php

@@ -25,4 +25,19 @@ final class PartnerProgramType extends AbstractEnum
         self::TECHNOLOGY => 'Technology',
         self::CONSULTANT => 'Consultant',
     ];
+
+    /**
+     * @var array<string, float>
+     */
+    protected static array $optionWeights = [
+        self::NONE => 0.0,
+        self::CONSULTANT => 0.1,
+        self::SOLUTION => 0.2,
+        self::TECHNOLOGY => 0.45,
+    ];
+
+    public static function getWeight(?string $option): float
+    {
+        return self::$optionWeights[$option] ?? 0.0;
+    }
 }

src/Factory/CompanyFactory.php

@@ -53,8 +53,8 @@ public static function fromArray(array $data): Company
         foreach ($data['addresses'] ?? [] as $address) {
             $company->addAddress(AddressFactory::fromArray($address));
         }
-        if (isset($data['partnerProgram'])) {
-            $company->setPartnerProgram(SubscriptionFactory::fromArray($data['partnerProgram']));
+        foreach ($data['partnerPrograms'] ?? [] as $partnerProgram) {
+            $company->addPartnerProgram(SubscriptionFactory::fromArray($partnerProgram));
         }
         if (isset($data['membership'])) {
             $company->setMembership(SubscriptionFactory::fromArray($data['membership']));

tests/Api/CompanyApiTest.php

@@ -47,7 +47,7 @@ public function testGetCompany(): void
         self::assertEquals([
             'isFoundingPartner' => true,
             'membership' => 'GOLD',
-            'partnerType' => 'NONE',
+            'partnerTypes' => [],
         ], $response->getStatus());
     }
 

tests/Fixtures/GetCompanyResponse.php

@@ -161,7 +161,7 @@
   "status": {
     "isFoundingPartner": true,
     "membership": "GOLD",
-    "partnerType": "NONE"
+    "partnerTypes": []
   }
 }
 ');

tests/Fixtures/GetUserCompaniesResponse.php

@@ -26,7 +26,7 @@
             "status": {
                 "isFoundingPartner": false,
                 "membership": "ACADEMIC_BRONZE",
-                "partnerType": "NONE"
+                "partnerTypes": []
             }
         }
     }