Merge pull request #151 from alexschastny/add-entitlements-filter

Author: Brandin

spec/TwitchApi/Resources/EntitlementsApiSpec.php

@@ -70,6 +70,12 @@ function it_should_get_drop_entitlements_by_game_id_with_opts(RequestGenerator $
         $this->getDropsEntitlements('TEST_TOKEN', null, null, '123', 'abc', 100)->shouldBe($response);
     }
 
+    function it_should_get_drop_entitlements_by_status(RequestGenerator $requestGenerator, Request $request, Response $response)
+    {
+        $requestGenerator->generate('GET', 'entitlements/drops', 'TEST_TOKEN', [['key' => 'fulfillment_status', 'value' => 'CLAIMED']], [])->willReturn($request);
+        $this->getDropsEntitlements('TEST_TOKEN', null, null, null, null, null, 'CLAIMED')->shouldBe($response);
+    }
+
     function it_should_redeem_code(RequestGenerator $requestGenerator, Request $request, Response $response)
     {
         $requestGenerator->generate('POST', 'entitlements/code', 'TEST_TOKEN', [['key' => 'user_id', 'value' => '123'], ['key' => 'code', 'value' => 'abc']], [])->willReturn($request);

src/Resources/EntitlementsApi.php

@@ -43,7 +43,7 @@ public function getCodeStatus(string $bearer, int $userId, array $codes = []): R
      * @throws GuzzleException
      * @link https://dev.twitch.tv/docs/api/reference#get-drops-entitlements
      */
-    public function getDropsEntitlements(string $bearer, string $id = null, string $userId = null, string $gameId = null, string $after = null, int $first = null): ResponseInterface
+    public function getDropsEntitlements(string $bearer, string $id = null, string $userId = null, string $gameId = null, string $after = null, int $first = null, string $fulfillmentStatus = null): ResponseInterface
     {
         $queryParamsMap = [];
 
@@ -67,6 +67,10 @@ public function getDropsEntitlements(string $bearer, string $id = null, string $
             $queryParamsMap[] = ['key' => 'first', 'value' => $first];
         }
 
+        if ($fulfillmentStatus) {
+            $queryParamsMap[] = ['key' => 'fulfillment_status', 'value' => $fulfillmentStatus];
+        }
+
         return $this->getApi('entitlements/drops', $bearer, $queryParamsMap);
     }