LEARN-POEMS-T-35: add page title revision endpoint

src/DTO/Requests/PageRevisionRequest.php

@@ -0,0 +1,8 @@
+<?php
+
+namespace MediawikiSdkPhp\DTO\Requests;
+
+class PageRevisionRequest extends PageRequest
+{
+    public int $revision;
+}

src/Resources/WikiMedia/PageContentResource.php

@@ -4,6 +4,7 @@
 
 use JsonException;
 use MediawikiSdkPhp\DTO\Requests\PageRequest;
+use MediawikiSdkPhp\DTO\Requests\PageRevisionRequest;
 use MediawikiSdkPhp\DTO\Responses\GetPageSummary;
 use MediawikiSdkPhp\DTO\Responses\GetPageTitlesList;
 use MediawikiSdkPhp\Exceptions\MediaWikiException;
@@ -39,4 +40,18 @@ public function getTitle(array $params): GetPageTitlesList
         $url = "page/title/{$params['title']}";
         return $this->adapter->handle('get', $url, GetPageTitlesList::class);
     }
+
+    /**
+     * @param array $params
+     * @return GetPageTitlesList
+     * @throws MediaWikiException
+     * @throws JsonException
+     */
+    public function getTitleRevision(array $params): GetPageTitlesList
+    {
+        $this->validateParams(PageRevisionRequest::class, $params);
+
+        $url = "page/title/{$params['title']}/{$params['revision']}";
+        return $this->adapter->handle('get', $url, GetPageTitlesList::class);
+    }
 }

tests/Resources/PageContentResourceTest.php

@@ -67,6 +67,33 @@ public function testGetTitleNotFound(): void
 
         $this->wiki->pageContent()->getTitle($params);
     }
+
+    /**
+     * @throws JsonException
+     * @throws MediaWikiException
+     */
+    public function testGetTitleRevisionSuccess(): void
+    {
+        $params   = ['title' => 'Jupiter'];
+        $pageTitleResponse = $this->wiki->pageContent()->getTitle($params)->toArray();
+        $params['revision'] = $pageTitleResponse['items'][0]['rev'];
+
+        $response = $this->wiki->pageContent()->getTitleRevision($params);
+
+        $this->assertInstanceOf(GetPageTitlesList::class, $response);
+    }
+
+    /**
+     * @throws JsonException
+     * @throws MediaWikiException
+     */
+    public function testGetTitleRevisionNotFound(): void
+    {
+        $params = ['title' => 'hflk;aHF', 'revision' => 1];
+        $this->expectException(MediaWikiException::class);
+
+        $this->wiki->pageContent()->getTitleRevision($params);
+    }
 }