feat: added player resource

docs/03-supported-endpoints.md

@@ -505,23 +505,17 @@ $response = $api->livescores()->getAllLastUpdated();
 ### Players
 
 - [Official documentation](https://docs.sportmonks.com/football/endpoints-and-entities/endpoints/players)
-- Cache default max age: `1 day`
-  - `getAllLastUpdated` cache max age: `1 hour`
 
 #### `getAll`
 
 ```php
-getAll(int $page = 1, int $perPage = 25, string $order = 'asc'): PlayerCollection
+getAll(): PlayerCollection
 ```
 
 Get all players:
 
 ```php
-$players = $sportMonksFootball->players()->getAll();
-
-foreach ($players->getData() as $player) {
-    echo $player->getDisplayName();
-}
+$response = $api->players()->getAll();
 ```
 
 #### `getById`
@@ -533,40 +527,31 @@ getById(int $id): PlayerItem
 Get player by id:
 
 ```php
-$player = $sportMonksFootball->players()->getById(1);
-echo $player->getData()->getDisplayName();
+$response = $api->players()->getById(1);
 ```
 
 #### `getAllByCountryId`
 
 ```php
-getAllByCountryId(int $countryId, int $page = 1, int $perPage = 25, string $order = 'asc'): PlayerCollection
+getAllByCountryId(int $countryId): PlayerCollection
 ```
 
 Get all players by country id:
 
 ```php
-$players = $sportMonksFootball->players()->getAllByCountryId(1);
-
-foreach ($players->getData() as $player) {
-    echo $player->getDisplayName();
-}
+$response = $api->players()->getAllByCountryId(1);
 ```
 
 #### `getAllBySearchQuery`
 
 ```php
-getAllBySearchQuery(string $query, int $page = 1, int $perPage = 25, string $order = 'asc'): PlayerCollection
+getAllBySearchQuery(string $query): PlayerCollection
 ```
 
 Get all players by search query:
 
 ```php
-$players = $sportMonksFootball->players()->getAllBySearchQuery('esgaio');
-
-foreach ($players->getData() as $player) {
-    echo $player->getDisplayName();
-}
+$response = $api->players()->getAllBySearchQuery('esgaio');
 ```
 
 #### `getAllLastUpdated`
@@ -578,16 +563,9 @@ getAllLastUpdated(): PlayerCollection
 Get all players that received updates in the last couple of hours:
 
 ```php
-$players = $sportMonksFootball->players()->getAllLastUpdated();
-
-foreach ($players->getData() as $player) {
-    echo $player->getDisplayName();
-}
+$response = $api->players()->getAllLastUpdated();
 ```
 
-> **Note**
-> Cache max age is forced to `1 hour` on this endpoint.
-
 ### Referees
 
 - [Official documentation](https://docs.sportmonks.com/football/endpoints-and-entities/endpoints/referees)

docs/05-entities.md

@@ -454,7 +454,7 @@
 - `getImagePath()`: `?string`
 - `getHeight()`: `?int`
 - `getWeight()`: `?int`
-- `getDateOfBirth()`: `?\DateTimeImmutable`
+- `getBirthdate()`: `?\DateTimeImmutable`
 - `getGender()`: `?string`
 - `inSquad()`: `?bool`
 - `getSport()`: [`?Sport`](#sport) (`sport` include is required)

src/Entity/Player.php

@@ -40,7 +40,7 @@ class Player
 
     private ?int $weight;
 
-    private ?\DateTimeImmutable $dateOfBirth;
+    private ?\DateTimeImmutable $birthdate;
 
     private ?string $gender;
 
@@ -102,7 +102,7 @@ public function __construct(array $data, string $timezone)
         $this->imagePath = $data['image_path'] ?? null;
         $this->height = $data['height'] ?? null;
         $this->weight = $data['weight'] ?? null;
-        $this->dateOfBirth = isset($data['date_of_birth']) ? new \DateTimeImmutable($data['date_of_birth']) : null;
+        $this->birthdate = isset($data['date_of_birth']) ? new \DateTimeImmutable($data['date_of_birth']) : null;
         $this->gender = $data['gender'] ?? null;
         $this->inSquad = $data['in_squad'] ?? null;
 
@@ -203,9 +203,9 @@ public function getWeight(): ?int
         return $this->weight;
     }
 
-    public function getDateOfBirth(): ?\DateTimeImmutable
+    public function getBirthdate(): ?\DateTimeImmutable
     {
-        return $this->dateOfBirth;
+        return $this->birthdate;
     }
 
     public function getGender(): ?string

src/Resource/PlayerResource.php

@@ -0,0 +1,88 @@
+<?php
+
+namespace ProgrammatorDev\SportMonksFootball\Resource;
+
+use ProgrammatorDev\SportMonksFootball\Entity\Response\PlayerCollection;
+use ProgrammatorDev\SportMonksFootball\Entity\Response\PlayerItem;
+use ProgrammatorDev\SportMonksFootball\Resource\Util\PaginationTrait;
+use ProgrammatorDev\Validator\Exception\ValidationException;
+use Psr\Http\Client\ClientExceptionInterface;
+
+class PlayerResource extends Resource
+{
+    use PaginationTrait;
+
+    /**
+     * @throws ClientExceptionInterface
+     */
+    public function getAll(): PlayerCollection
+    {
+        $data = $this->api->request(
+            method: 'GET',
+            path: '/v3/football/players'
+        );
+
+        return new PlayerCollection($data);
+    }
+
+    /**
+     * @throws ClientExceptionInterface
+     */
+    public function getById(int $id): PlayerItem
+    {
+        $data = $this->api->request(
+            method: 'GET',
+            path: $this->api->buildPath('/v3/football/players/{id}', [
+                'id' => $id
+            ])
+        );
+
+        return new PlayerItem($data);
+    }
+
+    /**
+     * @throws ClientExceptionInterface
+     */
+    public function getAllByCountryId(int $countryId): PlayerCollection
+    {
+        $data = $this->api->request(
+            method: 'GET',
+            path: $this->api->buildPath('/v3/football/players/countries/{countryId}', [
+                'countryId' => $countryId
+            ])
+        );
+
+        return new PlayerCollection($data);
+    }
+
+    /**
+     * @throws ValidationException
+     * @throws ClientExceptionInterface
+     */
+    public function getAllBySearchQuery(string $query): PlayerCollection
+    {
+        $this->validateQuery($query, 'query');
+
+        $data = $this->api->request(
+            method: 'GET',
+            path: $this->api->buildPath('/v3/football/players/search/{query}', [
+                'query' => $query
+            ])
+        );
+
+        return new PlayerCollection($data);
+    }
+
+    /**
+     * @throws ClientExceptionInterface
+     */
+    public function getAllLastUpdated(): PlayerCollection
+    {
+        $data = $this->api->request(
+            method: 'GET',
+            path: '/v3/football/players/latest'
+        );
+
+        return new PlayerCollection($data);
+    }
+}

src/SportMonksFootball.php

@@ -38,6 +38,7 @@
 use ProgrammatorDev\SportMonksFootball\Resource\LeagueResource;
 use ProgrammatorDev\SportMonksFootball\Resource\LivescoreResource;
 use ProgrammatorDev\SportMonksFootball\Resource\MarketResource;
+use ProgrammatorDev\SportMonksFootball\Resource\PlayerResource;
 
 class SportMonksFootball extends Api
 {
@@ -109,11 +110,11 @@ public function markets(): MarketResource
         return new MarketResource($this);
     }
 
-//    public function players(): PlayerEndpoint
-//    {
-//        return new PlayerEndpoint($this);
-//    }
-//
+    public function players(): PlayerResource
+    {
+        return new PlayerResource($this);
+    }
+
 //    public function preMatchOdds(): PreMatchOddEndpoint
 //    {
 //        return new PreMatchOddEndpoint($this);