feat: added schedule resource

docs/03-supported-endpoints.md

@@ -713,7 +713,6 @@ $response = $api->rounds()->getAllBySearchQuery('30');
 ### Schedules
 
 - [Official documentation](https://docs.sportmonks.com/football/endpoints-and-entities/endpoints/schedules)
-- Cache default max age: `1 hour`
 
 #### `getAllBySeasonId`
 
@@ -724,19 +723,7 @@ getAllBySeasonId(int $seasonId): StageCollection
 Get complete season schedule by season id:
 
 ```php
-$schedule = $sportMonksFootball->schedules()->getAllBySeasonId(1);
-
-foreach ($schedule->getData() as $stage) {
-    echo $stage->getName();
-
-    foreach ($stage->getRounds() as $round) {
-        echo $round->getName();
-
-        foreach ($round->getFixtures() as $fixture) {
-            echo $fixture->getName();
-        }
-    }
-}
+$response = $api->schedules()->getAllBySeasonId(1);
 ```
 
 #### `getAllByTeamId`
@@ -748,19 +735,7 @@ getAllByTeamId(int $teamId): StageCollection
 Get complete schedule for all active seasons by team id:
 
 ```php
-$schedule = $sportMonksFootball->schedules()->getAllByTeamId(1);
-
-foreach ($schedule->getData() as $stage) {
-    echo $stage->getName();
-
-    foreach ($stage->getRounds() as $round) {
-        echo $round->getName();
-
-        foreach ($round->getFixtures() as $fixture) {
-            echo $fixture->getName();
-        }
-    }
-}
+$response = $api->schedules()->getAllByTeamId(1);
 ```
 
 #### `getAllBySeasonIdAndTeamId`
@@ -772,19 +747,7 @@ getAllBySeasonIdAndTeamId(int $seasonId, int $teamId): StageCollection
 Get complete season schedule for one team by season id and team id:
 
 ```php
-$schedule = $sportMonksFootball->schedules()->getAllBySeasonIdAndTeamId(1, 1);
-
-foreach ($schedule->getData() as $stage) {
-    echo $stage->getName();
-
-    foreach ($stage->getRounds() as $round) {
-        echo $round->getName();
-
-        foreach ($round->getFixtures() as $fixture) {
-            echo $fixture->getName();
-        }
-    }
-}
+$response = $api->schedules()->getAllBySeasonIdAndTeamId(1, 1);
 ```
 
 ### Seasons

src/Resource/ScheduleResource.php

@@ -0,0 +1,55 @@
+<?php
+
+namespace ProgrammatorDev\SportMonksFootball\Resource;
+
+use ProgrammatorDev\SportMonksFootball\Entity\Response\StageCollection;
+use Psr\Http\Client\ClientExceptionInterface;
+
+class ScheduleResource extends Resource
+{
+    /**
+     * @throws ClientExceptionInterface
+     */
+    public function getAllBySeasonId(int $seasonId): StageCollection
+    {
+        $data = $this->api->request(
+            method: 'GET',
+            path: $this->api->buildPath('/v3/football/schedules/seasons/{seasonId}', [
+                'seasonId' => $seasonId
+            ])
+        );
+
+        return new StageCollection($data);
+    }
+
+    /**
+     * @throws ClientExceptionInterface
+     */
+    public function getAllByTeamId(int $teamId): StageCollection
+    {
+        $data = $this->api->request(
+            method: 'GET',
+            path: $this->api->buildPath('/v3/football/schedules/teams/{teamId}', [
+                'teamId' => $teamId
+            ])
+        );
+
+        return new StageCollection($data);
+    }
+
+    /**
+     * @throws ClientExceptionInterface
+     */
+    public function getAllBySeasonIdAndTeamId(int $seasonId, int $teamId): StageCollection
+    {
+        $data = $this->api->request(
+            method: 'GET',
+            path: $this->api->buildPath('/v3/football/schedules/seasons/{seasonId}/teams/{teamId}', [
+                'seasonId' => $seasonId,
+                'teamId' => $teamId
+            ])
+        );
+
+        return new StageCollection($data);
+    }
+}

src/SportMonksFootball.php

@@ -43,6 +43,7 @@
 use ProgrammatorDev\SportMonksFootball\Resource\RegionResource;
 use ProgrammatorDev\SportMonksFootball\Resource\RivalResource;
 use ProgrammatorDev\SportMonksFootball\Resource\RoundResource;
+use ProgrammatorDev\SportMonksFootball\Resource\ScheduleResource;
 
 class SportMonksFootball extends Api
 {
@@ -144,11 +145,11 @@ public function rounds(): RoundResource
         return new RoundResource($this);
     }
 
-//    public function schedules(): ScheduleEndpoint
-//    {
-//        return new ScheduleEndpoint($this);
-//    }
-//
+    public function schedules(): ScheduleResource
+    {
+        return new ScheduleResource($this);
+    }
+
 //    public function seasons(): SeasonEndpoint
 //    {
 //        return new SeasonEndpoint($this);

tests/Integration/ScheduleResourceTest.php

@@ -0,0 +1,38 @@
+<?php
+
+namespace ProgrammatorDev\SportMonksFootball\Test\Integration;
+
+use ProgrammatorDev\SportMonksFootball\Entity\Response\StageCollection;
+use ProgrammatorDev\SportMonksFootball\Test\AbstractTest;
+use ProgrammatorDev\SportMonksFootball\Test\MockResponse;
+use ProgrammatorDev\SportMonksFootball\Test\Util\TestCollectionResponseTrait;
+
+class ScheduleResourceTest extends AbstractTest
+{
+    use TestCollectionResponseTrait;
+
+    public static function provideCollectionResponseData(): \Generator
+    {
+        yield 'get all by season id' => [
+            StageCollection::class,
+            MockResponse::STAGE_COLLECTION_DATA,
+            'schedules',
+            'getAllBySeasonId',
+            [1]
+        ];
+        yield 'get all by team id' => [
+            StageCollection::class,
+            MockResponse::STAGE_COLLECTION_DATA,
+            'schedules',
+            'getAllByTeamId',
+            [1]
+        ];
+        yield 'get all by season id and team id' => [
+            StageCollection::class,
+            MockResponse::STAGE_COLLECTION_DATA,
+            'schedules',
+            'getAllBySeasonIdAndTeamId',
+            [1, 1]
+        ];
+    }
+}

tests/Integration/SportMonksFootballTest.php

@@ -19,6 +19,7 @@
 use ProgrammatorDev\SportMonksFootball\Resource\RegionResource;
 use ProgrammatorDev\SportMonksFootball\Resource\RivalResource;
 use ProgrammatorDev\SportMonksFootball\Resource\RoundResource;
+use ProgrammatorDev\SportMonksFootball\Resource\ScheduleResource;
 use ProgrammatorDev\SportMonksFootball\Test\AbstractTest;
 
 class SportMonksFootballTest extends AbstractTest
@@ -42,5 +43,6 @@ public function testMethods()
         $this->assertInstanceOf(RegionResource::class, $this->api->regions());
         $this->assertInstanceOf(RivalResource::class, $this->api->rivals());
         $this->assertInstanceOf(RoundResource::class, $this->api->rounds());
+        $this->assertInstanceOf(ScheduleResource::class, $this->api->schedules());
     }
 }

tests/Unit/StageTest.php

@@ -0,0 +1,42 @@
+<?php
+
+namespace ProgrammatorDev\SportMonksFootball\Test\Unit;
+
+use ProgrammatorDev\SportMonksFootball\Entity\Stage;
+use ProgrammatorDev\SportMonksFootball\Test\AbstractTest;
+
+class StageTest extends AbstractTest
+{
+    public function testMethods(): void
+    {
+        $entity = new Stage([
+            'id' => 1,
+            'sport_id' => 1,
+            'league_id' => 1,
+            'season_id' => 1,
+            'type_id' => 1,
+            'name' => 'name',
+            'sort_order' => 1,
+            'finished' => true,
+            'is_current' => false,
+            'starting_at' => '2024-01-01 16:00:00',
+            'ending_at' => '2024-01-07 16:00:00',
+            'games_in_current_week' => false,
+            'tie_breaker_rule_id' => 1
+        ], 'UTC');
+
+        $this->assertSame(1, $entity->getId());
+        $this->assertSame(1, $entity->getSportId());
+        $this->assertSame(1, $entity->getLeagueId());
+        $this->assertSame(1, $entity->getSeasonId());
+        $this->assertSame(1, $entity->getTypeId());
+        $this->assertSame('name', $entity->getName());
+        $this->assertSame(1, $entity->getSortOrder());
+        $this->assertSame(true, $entity->hasFinished());
+        $this->assertSame(false, $entity->isCurrent());
+        $this->assertInstanceOf(\DateTimeImmutable::class, $entity->getStartingAt());
+        $this->assertInstanceOf(\DateTimeImmutable::class, $entity->getEndingAt());
+        $this->assertSame(false, $entity->hasGamesInCurrentWeek());
+        $this->assertSame(1, $entity->getTieBreakerRuleId());
+    }
+}