feat: added livescore resource

docs/03-supported-endpoints.md

@@ -465,8 +465,6 @@ $response = $api->leagues()->getAllCurrentByTeamId(1);
 ### Livescores
 
 - [Official documentation](https://docs.sportmonks.com/football/endpoints-and-entities/endpoints/livescores)
-- Cache default max age: `1 minute`
-  - `getAllLastUpdated` cache max age: `10 seconds`
 
 #### `getAll`
 
@@ -477,11 +475,7 @@ getAll(): FixtureCollection
 Get all fixtures of the current day:
 
 ```php
-$fixtures = $sportMonksFootball->livescores()->getAll();
-
-foreach ($fixtures->getData() as $fixture) {
-    echo $fixture->getName();
-}
+$response = $api->livescores()->getAll();
 ```
 
 #### `getAllInplay`
@@ -493,11 +487,7 @@ getAllInplay(): FixtureCollection
 Get all fixtures that are already live, that will start within 15 minutes or that have finished in the past 15 minutes:
 
 ```php
-$fixtures = $sportMonksFootball->livescores()->getAllInplay();
-
-foreach ($fixtures->getData() as $fixture) {
-    echo $fixture->getName();
-}
+$response = $api->livescores()->getAllInplay();
 ```
 
 #### `getAllLastUpdated`
@@ -509,16 +499,9 @@ getAllLastUpdated(): FixtureCollection
 Get all fixtures that received updates in the last 10 seconds:
 
 ```php
-$fixtures = $sportMonksFootball->livescores()->getAllLastUpdated();
-
-foreach ($fixtures->getData() as $fixture) {
-    echo $fixture->getName();
-}
+$response = $api->livescores()->getAllLastUpdated();
 ```
 
-> **Note**
-> Cache max age is forced to `10 seconds` on this endpoint.
-
 ### Players
 
 - [Official documentation](https://docs.sportmonks.com/football/endpoints-and-entities/endpoints/players)

src/Resource/LivescoreResource.php

@@ -0,0 +1,48 @@
+<?php
+
+namespace ProgrammatorDev\SportMonksFootball\Resource;
+
+use ProgrammatorDev\SportMonksFootball\Entity\Response\FixtureCollection;
+use Psr\Http\Client\ClientExceptionInterface;
+
+class LivescoreResource extends Resource
+{
+    /**
+     * @throws ClientExceptionInterface
+     */
+    public function getAll(): FixtureCollection
+    {
+        $data = $this->api->request(
+            method: 'GET',
+            path: '/v3/football/livescores'
+        );
+
+        return new FixtureCollection($data);
+    }
+
+    /**
+     * @throws ClientExceptionInterface
+     */
+    public function getAllInplay(): FixtureCollection
+    {
+        $data = $this->api->request(
+            method: 'GET',
+            path: '/v3/football/livescores/inplay'
+        );
+
+        return new FixtureCollection($data);
+    }
+
+    /**
+     * @throws ClientExceptionInterface
+     */
+    public function getAllLastUpdated(): FixtureCollection
+    {
+        $data = $this->api->request(
+            method: 'GET',
+            path: '/v3/football/livescores/latest'
+        );
+
+        return new FixtureCollection($data);
+    }
+}

src/SportMonksFootball.php

@@ -36,6 +36,7 @@
 use ProgrammatorDev\SportMonksFootball\Resource\FilterResource;
 use ProgrammatorDev\SportMonksFootball\Resource\FixtureResource;
 use ProgrammatorDev\SportMonksFootball\Resource\LeagueResource;
+use ProgrammatorDev\SportMonksFootball\Resource\LivescoreResource;
 
 class SportMonksFootball extends Api
 {
@@ -97,11 +98,11 @@ public function leagues(): LeagueResource
         return new LeagueResource($this);
     }
 
-//    public function livescores(): LivescoreEndpoint
-//    {
-//        return new LivescoreEndpoint($this);
-//    }
-//
+    public function livescores(): LivescoreResource
+    {
+        return new LivescoreResource($this);
+    }
+
 //    public function markets(): MarketEndpoint
 //    {
 //        return new MarketEndpoint($this);

tests/Integration/LivescoreResourceTest.php

@@ -0,0 +1,37 @@
+<?php
+
+namespace ProgrammatorDev\SportMonksFootball\Test\Integration;
+
+use ProgrammatorDev\SportMonksFootball\Entity\Response\BookmakerCollection;
+use ProgrammatorDev\SportMonksFootball\Entity\Response\BookmakerItem;
+use ProgrammatorDev\SportMonksFootball\Entity\Response\FixtureCollection;
+use ProgrammatorDev\SportMonksFootball\Test\AbstractTest;
+use ProgrammatorDev\SportMonksFootball\Test\MockResponse;
+use ProgrammatorDev\SportMonksFootball\Test\Util\TestCollectionResponseTrait;
+
+class LivescoreResourceTest extends AbstractTest
+{
+    use TestCollectionResponseTrait;
+
+    public static function provideCollectionResponseData(): \Generator
+    {
+        yield 'get all' => [
+            FixtureCollection::class,
+            MockResponse::FIXTURE_COLLECTION_DATA,
+            'livescores',
+            'getAll'
+        ];
+        yield 'get all inplay' => [
+            FixtureCollection::class,
+            MockResponse::FIXTURE_COLLECTION_DATA,
+            'livescores',
+            'getAllInplay'
+        ];
+        yield 'get all last updated' => [
+            FixtureCollection::class,
+            MockResponse::FIXTURE_COLLECTION_DATA,
+            'livescores',
+            'getAllLastUpdated'
+        ];
+    }
+}

tests/Integration/SportMonksFootballTest.php

@@ -11,6 +11,7 @@
 use ProgrammatorDev\SportMonksFootball\Resource\FilterResource;
 use ProgrammatorDev\SportMonksFootball\Resource\FixtureResource;
 use ProgrammatorDev\SportMonksFootball\Resource\LeagueResource;
+use ProgrammatorDev\SportMonksFootball\Resource\LivescoreResource;
 use ProgrammatorDev\SportMonksFootball\Test\AbstractTest;
 
 class SportMonksFootballTest extends AbstractTest
@@ -26,5 +27,6 @@ public function testMethods()
         $this->assertInstanceOf(FilterResource::class, $this->api->filters());
         $this->assertInstanceOf(FixtureResource::class, $this->api->fixtures());
         $this->assertInstanceOf(LeagueResource::class, $this->api->leagues());
+        $this->assertInstanceOf(LivescoreResource::class, $this->api->livescores());
     }
 }