From e3d89f807c3ea9bbb71fdbb2dd74c5e5b16d4ed8 Mon Sep 17 00:00:00 2001
From: eduardevdokimov <eduard.evdokimov@inbox.ru>
Date: Fri, 25 Nov 2022 11:43:53 +0300
Subject: [PATCH 1/7] LEARN-POEMS-T-36 Add mobile-sections endpoint

---
 README.md                                     | 16 +++++-
 src/DTO/Responses/Mobile/GetMobile.php        | 12 +++++
 src/DTO/Responses/Mobile/GetMobileImage.php   | 12 +++++
 .../Mobile/GetMobileLastModifier.php          | 12 +++++
 src/DTO/Responses/Mobile/GetMobileLead.php    | 50 +++++++++++++++++++
 .../Mobile/GetMobilePronunciation.php         | 10 ++++
 .../Responses/Mobile/GetMobileProtection.php  | 12 +++++
 .../Responses/Mobile/GetMobileRemaining.php   | 16 ++++++
 .../Responses/Mobile/GetMobileSections.php    | 20 ++++++++
 src/DTO/Responses/Mobile/GetMobileSpoken.php  | 10 ++++
 src/MediaWiki.php                             | 11 ++++
 src/Resources/WikiMedia/MobileResource.php    | 25 ++++++++++
 tests/Resources/MobileResourceTest.php        | 37 ++++++++++++++
 13 files changed, 242 insertions(+), 1 deletion(-)
 create mode 100644 src/DTO/Responses/Mobile/GetMobile.php
 create mode 100644 src/DTO/Responses/Mobile/GetMobileImage.php
 create mode 100644 src/DTO/Responses/Mobile/GetMobileLastModifier.php
 create mode 100644 src/DTO/Responses/Mobile/GetMobileLead.php
 create mode 100644 src/DTO/Responses/Mobile/GetMobilePronunciation.php
 create mode 100644 src/DTO/Responses/Mobile/GetMobileProtection.php
 create mode 100644 src/DTO/Responses/Mobile/GetMobileRemaining.php
 create mode 100644 src/DTO/Responses/Mobile/GetMobileSections.php
 create mode 100644 src/DTO/Responses/Mobile/GetMobileSpoken.php
 create mode 100644 src/Resources/WikiMedia/MobileResource.php
 create mode 100644 tests/Resources/MobileResourceTest.php

diff --git a/README.md b/README.md
index 57f1da8..9252a15 100644
--- a/README.md
+++ b/README.md
@@ -75,7 +75,8 @@ COMMONS_HOST="https://commons.wikimedia.org/"
 * pageContent
   * getPageSummary
   * getPageTitle
-* mobile - @ToDo
+* mobile
+  * getSections
 * feed - @ToDo
 * transforms - @ToDo
 * math - @ToDo
@@ -287,6 +288,19 @@ You can use this action for a typeahead search that automatically suggests relev
   $res = $wiki->pageContent()->getTitle($params); 
 ```
 
+### Mobile
+
+#### getSections
+
+Retrieve the latest HTML for a page title optimised for viewing with native mobile applications. 
+Note that the output is split by sections.
+
+```php
+  $wiki = new MediaWiki();
+  $params = ['title' => 'Jupiter'];
+  $res = $wiki->mobile()->getSections($params);
+```
+
 ## Request parameters validation
 
 For validation the package use `spatie/data-transfer-object` and `ekut/spatie-dto-validators`.
diff --git a/src/DTO/Responses/Mobile/GetMobile.php b/src/DTO/Responses/Mobile/GetMobile.php
new file mode 100644
index 0000000..a659e02
--- /dev/null
+++ b/src/DTO/Responses/Mobile/GetMobile.php
@@ -0,0 +1,12 @@
+<?php
+
+namespace MediawikiSdkPhp\DTO\Responses\Mobile;
+
+use Spatie\DataTransferObject\DataTransferObject;
+
+class GetMobile extends DataTransferObject
+{
+    public GetMobileLead $lead;
+
+    public GetMobileRemaining $remaining;
+}
diff --git a/src/DTO/Responses/Mobile/GetMobileImage.php b/src/DTO/Responses/Mobile/GetMobileImage.php
new file mode 100644
index 0000000..aac2c48
--- /dev/null
+++ b/src/DTO/Responses/Mobile/GetMobileImage.php
@@ -0,0 +1,12 @@
+<?php
+
+namespace MediawikiSdkPhp\DTO\Responses\Mobile;
+
+use Spatie\DataTransferObject\DataTransferObject;
+
+class GetMobileImage extends DataTransferObject
+{
+    public ?string $file;
+
+    public ?array $urls;
+}
diff --git a/src/DTO/Responses/Mobile/GetMobileLastModifier.php b/src/DTO/Responses/Mobile/GetMobileLastModifier.php
new file mode 100644
index 0000000..d7aa199
--- /dev/null
+++ b/src/DTO/Responses/Mobile/GetMobileLastModifier.php
@@ -0,0 +1,12 @@
+<?php
+
+namespace MediawikiSdkPhp\DTO\Responses\Mobile;
+
+use Spatie\DataTransferObject\DataTransferObject;
+
+class GetMobileLastModifier extends DataTransferObject
+{
+    public string $user;
+
+    public string $gender;
+}
diff --git a/src/DTO/Responses/Mobile/GetMobileLead.php b/src/DTO/Responses/Mobile/GetMobileLead.php
new file mode 100644
index 0000000..5907b3a
--- /dev/null
+++ b/src/DTO/Responses/Mobile/GetMobileLead.php
@@ -0,0 +1,50 @@
+<?php
+
+namespace MediawikiSdkPhp\DTO\Responses\Mobile;
+
+use Spatie\DataTransferObject\Attributes\CastWith;
+use Spatie\DataTransferObject\Casters\ArrayCaster;
+use Spatie\DataTransferObject\DataTransferObject;
+
+class GetMobileLead extends DataTransferObject
+{
+    public int $ns;
+
+    public int $id;
+
+    public string $revision;
+
+    public string $lastmodified;
+
+    public GetMobileLastModifier $lastmodifier;
+
+    public string $displaytitle;
+
+    public string $normalizedtitle;
+
+    public string $wikibase_item;
+
+    public string $description;
+
+    public string $description_source;
+
+    public GetMobileProtection $protection;
+
+    public bool $editable;
+
+    public int $languagecount;
+
+    public ?GetMobileImage $image;
+
+    public ?GetMobilePronunciation $pronunciation;
+
+    public ?GetMobileSpoken $spoken;
+
+    public ?array $hatnotes;
+
+    /**
+     * @var GetMobileSections[]
+     */
+    #[CastWith(ArrayCaster::class, itemType: GetMobileSections::class)]
+    public ?array $sections;
+}
diff --git a/src/DTO/Responses/Mobile/GetMobilePronunciation.php b/src/DTO/Responses/Mobile/GetMobilePronunciation.php
new file mode 100644
index 0000000..cf9c798
--- /dev/null
+++ b/src/DTO/Responses/Mobile/GetMobilePronunciation.php
@@ -0,0 +1,10 @@
+<?php
+
+namespace MediawikiSdkPhp\DTO\Responses\Mobile;
+
+use Spatie\DataTransferObject\DataTransferObject;
+
+class GetMobilePronunciation extends DataTransferObject
+{
+    public string $url;
+}
diff --git a/src/DTO/Responses/Mobile/GetMobileProtection.php b/src/DTO/Responses/Mobile/GetMobileProtection.php
new file mode 100644
index 0000000..71f1df8
--- /dev/null
+++ b/src/DTO/Responses/Mobile/GetMobileProtection.php
@@ -0,0 +1,12 @@
+<?php
+
+namespace MediawikiSdkPhp\DTO\Responses\Mobile;
+
+use Spatie\DataTransferObject\DataTransferObject;
+
+class GetMobileProtection extends DataTransferObject
+{
+    public ?array $edit;
+
+    public ?array $move;
+}
diff --git a/src/DTO/Responses/Mobile/GetMobileRemaining.php b/src/DTO/Responses/Mobile/GetMobileRemaining.php
new file mode 100644
index 0000000..1453fda
--- /dev/null
+++ b/src/DTO/Responses/Mobile/GetMobileRemaining.php
@@ -0,0 +1,16 @@
+<?php
+
+namespace MediawikiSdkPhp\DTO\Responses\Mobile;
+
+use Spatie\DataTransferObject\Attributes\CastWith;
+use Spatie\DataTransferObject\Casters\ArrayCaster;
+use Spatie\DataTransferObject\DataTransferObject;
+
+class GetMobileRemaining extends DataTransferObject
+{
+    /**
+     * @var GetMobileSections[]
+     */
+    #[CastWith(ArrayCaster::class, itemType: GetMobileSections::class)]
+    public array $sections;
+}
diff --git a/src/DTO/Responses/Mobile/GetMobileSections.php b/src/DTO/Responses/Mobile/GetMobileSections.php
new file mode 100644
index 0000000..9df0717
--- /dev/null
+++ b/src/DTO/Responses/Mobile/GetMobileSections.php
@@ -0,0 +1,20 @@
+<?php
+
+namespace MediawikiSdkPhp\DTO\Responses\Mobile;
+
+use Spatie\DataTransferObject\DataTransferObject;
+
+class GetMobileSections extends DataTransferObject
+{
+    public int $id;
+
+    public ?int $toclevel;
+
+    public ?string $anchor;
+
+    public ?string $line;
+
+    public ?string $text;
+
+    public ?bool $isReferenceSection;
+}
diff --git a/src/DTO/Responses/Mobile/GetMobileSpoken.php b/src/DTO/Responses/Mobile/GetMobileSpoken.php
new file mode 100644
index 0000000..48ac10f
--- /dev/null
+++ b/src/DTO/Responses/Mobile/GetMobileSpoken.php
@@ -0,0 +1,10 @@
+<?php
+
+namespace MediawikiSdkPhp\DTO\Responses\Mobile;
+
+use Spatie\DataTransferObject\DataTransferObject;
+
+class GetMobileSpoken extends DataTransferObject
+{
+    public array $files;
+}
diff --git a/src/MediaWiki.php b/src/MediaWiki.php
index 0cf8e8f..f7ee36d 100644
--- a/src/MediaWiki.php
+++ b/src/MediaWiki.php
@@ -8,6 +8,7 @@
 use MediawikiSdkPhp\Resources\MediaWiki\PageResource;
 use MediawikiSdkPhp\Resources\MediaWiki\RevisionResource;
 use MediawikiSdkPhp\Resources\MediaWiki\SearchResource;
+use MediawikiSdkPhp\Resources\WikiMedia\MobileResource;
 use MediawikiSdkPhp\Resources\WikiMedia\PageContentResource;
 
 class MediaWiki
@@ -17,6 +18,7 @@ class MediaWiki
     private ?RevisionResource $revision = null;
     private ?SearchResource   $search   = null;
     private ?PageContentResource $pageContent = null;
+    private ?MobileResource $mobile = null;
 
     public function __construct(private $lang = 'en')
     {
@@ -69,6 +71,15 @@ public function search(): SearchResource
         return $this->search;
     }
 
+    public function mobile(): MobileResource
+    {
+        if (is_null($this->mobile)) {
+            $this->mobile = new MobileResource($this->lang);
+        }
+
+        return $this->mobile;
+    }
+
     /**
      * @throws MediaWikiException
      */
diff --git a/src/Resources/WikiMedia/MobileResource.php b/src/Resources/WikiMedia/MobileResource.php
new file mode 100644
index 0000000..9aa54a4
--- /dev/null
+++ b/src/Resources/WikiMedia/MobileResource.php
@@ -0,0 +1,25 @@
+<?php
+
+namespace MediawikiSdkPhp\Resources\WikiMedia;
+
+use JsonException;
+use MediawikiSdkPhp\DTO\Requests\PageRequest;
+use MediawikiSdkPhp\DTO\Responses\Mobile\GetMobile;
+use MediawikiSdkPhp\Exceptions\MediaWikiException;
+use MediawikiSdkPhp\Resources\AbstractWikiMediaResource;
+
+class MobileResource extends AbstractWikiMediaResource
+{
+    /**
+     * @throws JsonException
+     * @throws MediaWikiException
+     */
+    public function getSections(array $params): mixed
+    {
+        $this->validateParams(PageRequest::class, $params);
+
+        $url = "page/mobile-sections/{$params['title']}";
+
+        return $this->adapter->handle('get', $url, GetMobile::class);
+    }
+}
diff --git a/tests/Resources/MobileResourceTest.php b/tests/Resources/MobileResourceTest.php
new file mode 100644
index 0000000..c2723e8
--- /dev/null
+++ b/tests/Resources/MobileResourceTest.php
@@ -0,0 +1,37 @@
+<?php
+
+namespace Resources;
+
+use MediawikiSdkPhp\DTO\Responses\Mobile\GetMobile;
+use MediawikiSdkPhp\Exceptions\MediaWikiException;
+use MediawikiSdkPhp\MediaWiki;
+use PHPUnit\Framework\TestCase;
+
+class MobileResourceTest extends TestCase
+{
+    protected function setUp(): void
+    {
+        $this->wiki = new MediaWiki();
+
+        parent::setUp();
+    }
+
+    public function testGetSections(): void
+    {
+        $params = ['title' => 'Jupiter'];
+
+        $response = $this->wiki->mobile()->getSections($params);
+
+        $this->assertInstanceOf(GetMobile::class, $response);
+    }
+
+    public function testGetSectionsNotFound(): void
+    {
+        $params = ['title' => 'hflk;aHF'];
+        $this->expectException(MediaWikiException::class);
+        $this->expectExceptionCode(404);
+        $this->expectExceptionMessage('Page or revision not found.');
+
+        $this->wiki->mobile()->getSections($params);
+    }
+}

From 6af49ac8cb631e7eab585d12392aa18cc4ac6acc Mon Sep 17 00:00:00 2001
From: eduardevdokimov <eduard.evdokimov@inbox.ru>
Date: Sun, 27 Nov 2022 10:18:06 +0300
Subject: [PATCH 2/7] LEARN-POEMS-T-36 Add
 /page/mobile-sections/{title}/{revision} endpoint

---
 README.md                                    | 12 +++++++++---
 src/DTO/Requests/PageRequestWithRevision.php | 14 ++++++++++++++
 src/Resources/WikiMedia/MobileResource.php   | 14 ++++++++++++++
 tests/Resources/MobileResourceTest.php       | 18 ++++++++++++++++++
 4 files changed, 55 insertions(+), 3 deletions(-)
 create mode 100644 src/DTO/Requests/PageRequestWithRevision.php

diff --git a/README.md b/README.md
index 9252a15..0412d3a 100644
--- a/README.md
+++ b/README.md
@@ -77,6 +77,7 @@ COMMONS_HOST="https://commons.wikimedia.org/"
   * getPageTitle
 * mobile
   * getSections
+  * getSectionsByRevision
 * feed - @ToDo
 * transforms - @ToDo
 * math - @ToDo
@@ -292,15 +293,20 @@ You can use this action for a typeahead search that automatically suggests relev
 
 #### getSections
 
-Retrieve the latest HTML for a page title optimised for viewing with native mobile applications. 
-Note that the output is split by sections.
-
 ```php
   $wiki = new MediaWiki();
   $params = ['title' => 'Jupiter'];
   $res = $wiki->mobile()->getSections($params);
 ```
 
+#### getSectionsByRevision
+
+```php
+  $wiki = new MediaWiki();
+  $params = ['title' => 'Jupiter', 'revision' => 1124023924];
+  $res = $wiki->mobile()->getSectionsByRevision($params);
+```
+
 ## Request parameters validation
 
 For validation the package use `spatie/data-transfer-object` and `ekut/spatie-dto-validators`.
diff --git a/src/DTO/Requests/PageRequestWithRevision.php b/src/DTO/Requests/PageRequestWithRevision.php
new file mode 100644
index 0000000..6f612b3
--- /dev/null
+++ b/src/DTO/Requests/PageRequestWithRevision.php
@@ -0,0 +1,14 @@
+<?php
+
+namespace MediawikiSdkPhp\DTO\Requests;
+
+use Spatie\DataTransferObject\Attributes\Strict;
+use Spatie\DataTransferObject\DataTransferObject;
+
+#[Strict]
+class PageRequestWithRevision extends DataTransferObject
+{
+    public string $title;
+
+    public int $revision;
+}
diff --git a/src/Resources/WikiMedia/MobileResource.php b/src/Resources/WikiMedia/MobileResource.php
index 9aa54a4..d44d228 100644
--- a/src/Resources/WikiMedia/MobileResource.php
+++ b/src/Resources/WikiMedia/MobileResource.php
@@ -4,6 +4,7 @@
 
 use JsonException;
 use MediawikiSdkPhp\DTO\Requests\PageRequest;
+use MediawikiSdkPhp\DTO\Requests\PageRequestWithRevision;
 use MediawikiSdkPhp\DTO\Responses\Mobile\GetMobile;
 use MediawikiSdkPhp\Exceptions\MediaWikiException;
 use MediawikiSdkPhp\Resources\AbstractWikiMediaResource;
@@ -22,4 +23,17 @@ public function getSections(array $params): mixed
 
         return $this->adapter->handle('get', $url, GetMobile::class);
     }
+
+    /**
+     * @throws MediaWikiException
+     * @throws JsonException
+     */
+    public function getSectionsByRevision(array $params): mixed
+    {
+        $this->validateParams(PageRequestWithRevision::class, $params);
+
+        $url = "page/mobile-sections/{$params['title']}/{$params['revision']}";
+
+        return $this->adapter->handle('get', $url, GetMobile::class);
+    }
 }
diff --git a/tests/Resources/MobileResourceTest.php b/tests/Resources/MobileResourceTest.php
index c2723e8..ab841bb 100644
--- a/tests/Resources/MobileResourceTest.php
+++ b/tests/Resources/MobileResourceTest.php
@@ -34,4 +34,22 @@ public function testGetSectionsNotFound(): void
 
         $this->wiki->mobile()->getSections($params);
     }
+
+    public function testGetSectionsByRevision(): void
+    {
+        $params = ['title' => 'Jupiter', 'revision' => 1124023924];
+
+        $response = $this->wiki->mobile()->getSectionsByRevision($params);
+
+        $this->assertInstanceOf(GetMobile::class, $response);
+    }
+
+    public function testGetSectionsByRevisionNotFound(): void
+    {
+        $params = ['title' => 'hflk;aHF', 'revision' => 123];
+        $this->expectException(MediaWikiException::class);
+        $this->expectExceptionCode(404);
+
+        $this->wiki->mobile()->getSectionsByRevision($params);
+    }
 }

From e1bc86bbeeeac7f19ba35dd901abefb3609d262d Mon Sep 17 00:00:00 2001
From: eduardevdokimov <eduard.evdokimov@inbox.ru>
Date: Sun, 27 Nov 2022 10:32:29 +0300
Subject: [PATCH 3/7] LEARN-POEMS-T-36 Add /page/mobile-sections-lead/{title}
 endpoint

---
 README.md                                  |  9 +++++++++
 src/Resources/WikiMedia/MobileResource.php | 14 ++++++++++++++
 tests/Resources/MobileResourceTest.php     | 20 ++++++++++++++++++++
 3 files changed, 43 insertions(+)

diff --git a/README.md b/README.md
index 0412d3a..e68216e 100644
--- a/README.md
+++ b/README.md
@@ -78,6 +78,7 @@ COMMONS_HOST="https://commons.wikimedia.org/"
 * mobile
   * getSections
   * getSectionsByRevision
+  * getSectionsLead
 * feed - @ToDo
 * transforms - @ToDo
 * math - @ToDo
@@ -307,6 +308,14 @@ You can use this action for a typeahead search that automatically suggests relev
   $res = $wiki->mobile()->getSectionsByRevision($params);
 ```
 
+#### getSectionsLead
+
+```php
+  $wiki = new MediaWiki();
+  $params = ['title' => 'Jupiter'];
+  $res = $wiki->mobile()->getSectionsLead($params);
+```
+
 ## Request parameters validation
 
 For validation the package use `spatie/data-transfer-object` and `ekut/spatie-dto-validators`.
diff --git a/src/Resources/WikiMedia/MobileResource.php b/src/Resources/WikiMedia/MobileResource.php
index d44d228..e3c7161 100644
--- a/src/Resources/WikiMedia/MobileResource.php
+++ b/src/Resources/WikiMedia/MobileResource.php
@@ -6,6 +6,7 @@
 use MediawikiSdkPhp\DTO\Requests\PageRequest;
 use MediawikiSdkPhp\DTO\Requests\PageRequestWithRevision;
 use MediawikiSdkPhp\DTO\Responses\Mobile\GetMobile;
+use MediawikiSdkPhp\DTO\Responses\Mobile\GetMobileLead;
 use MediawikiSdkPhp\Exceptions\MediaWikiException;
 use MediawikiSdkPhp\Resources\AbstractWikiMediaResource;
 
@@ -36,4 +37,17 @@ public function getSectionsByRevision(array $params): mixed
 
         return $this->adapter->handle('get', $url, GetMobile::class);
     }
+
+    /**
+     * @throws MediaWikiException
+     * @throws JsonException
+     */
+    public function getSectionsLead(array $params): mixed
+    {
+        $this->validateParams(PageRequest::class, $params);
+
+        $url = "page/mobile-sections-lead/{$params['title']}";
+
+        return $this->adapter->handle('get', $url, GetMobileLead::class);
+    }
 }
diff --git a/tests/Resources/MobileResourceTest.php b/tests/Resources/MobileResourceTest.php
index ab841bb..b02b0c7 100644
--- a/tests/Resources/MobileResourceTest.php
+++ b/tests/Resources/MobileResourceTest.php
@@ -3,6 +3,7 @@
 namespace Resources;
 
 use MediawikiSdkPhp\DTO\Responses\Mobile\GetMobile;
+use MediawikiSdkPhp\DTO\Responses\Mobile\GetMobileLead;
 use MediawikiSdkPhp\Exceptions\MediaWikiException;
 use MediawikiSdkPhp\MediaWiki;
 use PHPUnit\Framework\TestCase;
@@ -52,4 +53,23 @@ public function testGetSectionsByRevisionNotFound(): void
 
         $this->wiki->mobile()->getSectionsByRevision($params);
     }
+
+    public function testGetSectionsLead(): void
+    {
+        $params = ['title' => 'Jupiter'];
+
+        $response = $this->wiki->mobile()->getSectionsLead($params);
+
+        $this->assertInstanceOf(GetMobileLead::class, $response);
+    }
+
+    public function testGetSectionsLeadNotFound(): void
+    {
+        $params = ['title' => 'hflk;aHF'];
+        $this->expectException(MediaWikiException::class);
+        $this->expectExceptionCode(404);
+        $this->expectExceptionMessage('Page or revision not found.');
+
+        $this->wiki->mobile()->getSectionsLead($params);
+    }
 }

From 25fc49db3cb5ee4a8db7d398336ab03ab89dcc86 Mon Sep 17 00:00:00 2001
From: eduardevdokimov <eduard.evdokimov@inbox.ru>
Date: Sun, 27 Nov 2022 10:42:08 +0300
Subject: [PATCH 4/7] LEARN-POEMS-T-36 Add
 /page/mobile-sections-lead/{title}/{revision} endpoint

---
 README.md                                  |  9 +++++++++
 src/Resources/WikiMedia/MobileResource.php | 13 +++++++++++++
 tests/Resources/MobileResourceTest.php     | 18 ++++++++++++++++++
 3 files changed, 40 insertions(+)

diff --git a/README.md b/README.md
index e68216e..aee1cd3 100644
--- a/README.md
+++ b/README.md
@@ -79,6 +79,7 @@ COMMONS_HOST="https://commons.wikimedia.org/"
   * getSections
   * getSectionsByRevision
   * getSectionsLead
+  * getSectionsLeadByRevision
 * feed - @ToDo
 * transforms - @ToDo
 * math - @ToDo
@@ -316,6 +317,14 @@ You can use this action for a typeahead search that automatically suggests relev
   $res = $wiki->mobile()->getSectionsLead($params);
 ```
 
+#### getSectionsLeadByRevision
+
+```php
+  $wiki = new MediaWiki();
+  $params = ['title' => 'Jupiter', 'revision' => 1124023924];
+  $res = $wiki->mobile()->getSectionsLeadByRevision($params);
+```
+
 ## Request parameters validation
 
 For validation the package use `spatie/data-transfer-object` and `ekut/spatie-dto-validators`.
diff --git a/src/Resources/WikiMedia/MobileResource.php b/src/Resources/WikiMedia/MobileResource.php
index e3c7161..980305e 100644
--- a/src/Resources/WikiMedia/MobileResource.php
+++ b/src/Resources/WikiMedia/MobileResource.php
@@ -50,4 +50,17 @@ public function getSectionsLead(array $params): mixed
 
         return $this->adapter->handle('get', $url, GetMobileLead::class);
     }
+
+    /**
+     * @throws MediaWikiException
+     * @throws JsonException
+     */
+    public function getSectionsLeadByRevision(array $params): mixed
+    {
+        $this->validateParams(PageRequestWithRevision::class, $params);
+
+        $url = "page/mobile-sections-lead/{$params['title']}/{$params['revision']}";
+
+        return $this->adapter->handle('get', $url, GetMobileLead::class);
+    }
 }
diff --git a/tests/Resources/MobileResourceTest.php b/tests/Resources/MobileResourceTest.php
index b02b0c7..0133b3f 100644
--- a/tests/Resources/MobileResourceTest.php
+++ b/tests/Resources/MobileResourceTest.php
@@ -72,4 +72,22 @@ public function testGetSectionsLeadNotFound(): void
 
         $this->wiki->mobile()->getSectionsLead($params);
     }
+
+    public function testGetSectionsLeadByRevision(): void
+    {
+        $params = ['title' => 'Jupiter', 'revision' => 1124023924];
+
+        $response = $this->wiki->mobile()->getSectionsLeadByRevision($params);
+
+        $this->assertInstanceOf(GetMobileLead::class, $response);
+    }
+
+    public function testGetSectionsLeadByRevisionNotFound(): void
+    {
+        $params = ['title' => 'hflk;aHF', 'revision' => 123];
+        $this->expectException(MediaWikiException::class);
+        $this->expectExceptionCode(404);
+
+        $this->wiki->mobile()->getSectionsLeadByRevision($params);
+    }
 }

From d5e5880e80f660c794e28061a1e9f22ca26c857a Mon Sep 17 00:00:00 2001
From: eduardevdokimov <eduard.evdokimov@inbox.ru>
Date: Sun, 27 Nov 2022 11:15:09 +0300
Subject: [PATCH 5/7] LEARN-POEMS-T-36 Add
 /page/mobile-sections-remaining/{title} endpoint

---
 README.md                                    |  9 +++++++++
 src/DTO/Requests/PageRequestWithRevision.php |  5 +----
 src/Resources/WikiMedia/MobileResource.php   | 14 ++++++++++++++
 tests/Resources/MobileResourceTest.php       | 20 ++++++++++++++++++++
 4 files changed, 44 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index aee1cd3..4e6fbb1 100644
--- a/README.md
+++ b/README.md
@@ -80,6 +80,7 @@ COMMONS_HOST="https://commons.wikimedia.org/"
   * getSectionsByRevision
   * getSectionsLead
   * getSectionsLeadByRevision
+  * getSectionsRemaining
 * feed - @ToDo
 * transforms - @ToDo
 * math - @ToDo
@@ -325,6 +326,14 @@ You can use this action for a typeahead search that automatically suggests relev
   $res = $wiki->mobile()->getSectionsLeadByRevision($params);
 ```
 
+#### getSectionsRemaining
+
+```php
+  $wiki = new MediaWiki();
+  $params = ['title' => 'Jupiter'];
+  $res = $wiki->mobile()->getSectionsRemaining($params);
+```
+
 ## Request parameters validation
 
 For validation the package use `spatie/data-transfer-object` and `ekut/spatie-dto-validators`.
diff --git a/src/DTO/Requests/PageRequestWithRevision.php b/src/DTO/Requests/PageRequestWithRevision.php
index 6f612b3..9e7dd30 100644
--- a/src/DTO/Requests/PageRequestWithRevision.php
+++ b/src/DTO/Requests/PageRequestWithRevision.php
@@ -3,12 +3,9 @@
 namespace MediawikiSdkPhp\DTO\Requests;
 
 use Spatie\DataTransferObject\Attributes\Strict;
-use Spatie\DataTransferObject\DataTransferObject;
 
 #[Strict]
-class PageRequestWithRevision extends DataTransferObject
+class PageRequestWithRevision extends PageRequest
 {
-    public string $title;
-
     public int $revision;
 }
diff --git a/src/Resources/WikiMedia/MobileResource.php b/src/Resources/WikiMedia/MobileResource.php
index 980305e..826abf1 100644
--- a/src/Resources/WikiMedia/MobileResource.php
+++ b/src/Resources/WikiMedia/MobileResource.php
@@ -7,6 +7,7 @@
 use MediawikiSdkPhp\DTO\Requests\PageRequestWithRevision;
 use MediawikiSdkPhp\DTO\Responses\Mobile\GetMobile;
 use MediawikiSdkPhp\DTO\Responses\Mobile\GetMobileLead;
+use MediawikiSdkPhp\DTO\Responses\Mobile\GetMobileRemaining;
 use MediawikiSdkPhp\Exceptions\MediaWikiException;
 use MediawikiSdkPhp\Resources\AbstractWikiMediaResource;
 
@@ -63,4 +64,17 @@ public function getSectionsLeadByRevision(array $params): mixed
 
         return $this->adapter->handle('get', $url, GetMobileLead::class);
     }
+
+    /**
+     * @throws MediaWikiException
+     * @throws JsonException
+     */
+    public function getSectionsRemaining(array $params): mixed
+    {
+        $this->validateParams(PageRequest::class, $params);
+
+        $url = "page/mobile-sections-remaining/{$params['title']}";
+
+        return $this->adapter->handle('get', $url, GetMobileRemaining::class);
+    }
 }
diff --git a/tests/Resources/MobileResourceTest.php b/tests/Resources/MobileResourceTest.php
index 0133b3f..a924fe0 100644
--- a/tests/Resources/MobileResourceTest.php
+++ b/tests/Resources/MobileResourceTest.php
@@ -4,6 +4,7 @@
 
 use MediawikiSdkPhp\DTO\Responses\Mobile\GetMobile;
 use MediawikiSdkPhp\DTO\Responses\Mobile\GetMobileLead;
+use MediawikiSdkPhp\DTO\Responses\Mobile\GetMobileRemaining;
 use MediawikiSdkPhp\Exceptions\MediaWikiException;
 use MediawikiSdkPhp\MediaWiki;
 use PHPUnit\Framework\TestCase;
@@ -90,4 +91,23 @@ public function testGetSectionsLeadByRevisionNotFound(): void
 
         $this->wiki->mobile()->getSectionsLeadByRevision($params);
     }
+
+    public function testGetSectionsRemaining(): void
+    {
+        $params = ['title' => 'Jupiter'];
+
+        $response = $this->wiki->mobile()->getSectionsRemaining($params);
+
+        $this->assertInstanceOf(GetMobileRemaining::class, $response);
+    }
+
+    public function testGetSectionsRemainingNotFound(): void
+    {
+        $params = ['title' => 'hflk;aHF'];
+        $this->expectException(MediaWikiException::class);
+        $this->expectExceptionCode(404);
+        $this->expectExceptionMessage('Page or revision not found.');
+
+        $this->wiki->mobile()->getSectionsRemaining($params);
+    }
 }

From 70823170a00433cbd8afd54fe85c8e35d549e0ab Mon Sep 17 00:00:00 2001
From: eduardevdokimov <eduard.evdokimov@inbox.ru>
Date: Sun, 27 Nov 2022 11:24:01 +0300
Subject: [PATCH 6/7] LEARN-POEMS-T-36 Add
 /page/mobile-sections-remaining/{title}/{revision} endpoint

---
 README.md                                  |  9 +++++++++
 src/Resources/WikiMedia/MobileResource.php | 13 +++++++++++++
 tests/Resources/MobileResourceTest.php     | 18 ++++++++++++++++++
 3 files changed, 40 insertions(+)

diff --git a/README.md b/README.md
index 4e6fbb1..bf7c075 100644
--- a/README.md
+++ b/README.md
@@ -81,6 +81,7 @@ COMMONS_HOST="https://commons.wikimedia.org/"
   * getSectionsLead
   * getSectionsLeadByRevision
   * getSectionsRemaining
+  * getSectionsRemainingByRevision
 * feed - @ToDo
 * transforms - @ToDo
 * math - @ToDo
@@ -334,6 +335,14 @@ You can use this action for a typeahead search that automatically suggests relev
   $res = $wiki->mobile()->getSectionsRemaining($params);
 ```
 
+#### getSectionsRemainingByRevision
+
+```php
+  $wiki = new MediaWiki();
+  $params = ['title' => 'Jupiter', 'revision' => 1124023924];
+  $res = $wiki->mobile()->getSectionsRemainingByRevision($params);
+```
+
 ## Request parameters validation
 
 For validation the package use `spatie/data-transfer-object` and `ekut/spatie-dto-validators`.
diff --git a/src/Resources/WikiMedia/MobileResource.php b/src/Resources/WikiMedia/MobileResource.php
index 826abf1..d7689d6 100644
--- a/src/Resources/WikiMedia/MobileResource.php
+++ b/src/Resources/WikiMedia/MobileResource.php
@@ -77,4 +77,17 @@ public function getSectionsRemaining(array $params): mixed
 
         return $this->adapter->handle('get', $url, GetMobileRemaining::class);
     }
+
+    /**
+     * @throws MediaWikiException
+     * @throws JsonException
+     */
+    public function getSectionsRemainingByRevision(array $params): mixed
+    {
+        $this->validateParams(PageRequestWithRevision::class, $params);
+
+        $url = "page/mobile-sections-remaining/{$params['title']}/{$params['revision']}";
+
+        return $this->adapter->handle('get', $url, GetMobileRemaining::class);
+    }
 }
diff --git a/tests/Resources/MobileResourceTest.php b/tests/Resources/MobileResourceTest.php
index a924fe0..c00c1a4 100644
--- a/tests/Resources/MobileResourceTest.php
+++ b/tests/Resources/MobileResourceTest.php
@@ -110,4 +110,22 @@ public function testGetSectionsRemainingNotFound(): void
 
         $this->wiki->mobile()->getSectionsRemaining($params);
     }
+
+    public function testGetSectionsRemainingByRevision(): void
+    {
+        $params = ['title' => 'Jupiter', 'revision' => 1124023924];
+
+        $response = $this->wiki->mobile()->getSectionsRemainingByRevision($params);
+
+        $this->assertInstanceOf(GetMobileRemaining::class, $response);
+    }
+
+    public function testGetSectionsRemainingByRevisionNotFound(): void
+    {
+        $params = ['title' => 'hflk;aHF', 'revision' => 123];
+        $this->expectException(MediaWikiException::class);
+        $this->expectExceptionCode(404);
+
+        $this->wiki->mobile()->getSectionsRemainingByRevision($params);
+    }
 }

From 5d26b225cd08b8d150bf3aac2e860e8cdc1ea541 Mon Sep 17 00:00:00 2001
From: eduardevdokimov <eduard.evdokimov@inbox.ru>
Date: Sun, 27 Nov 2022 16:27:42 +0300
Subject: [PATCH 7/7] LEARN-POEMS-T-36 Add /data/i18n/mobile/{type} endpoint

---
 README.md                                     |  9 ++
 src/DTO/Requests/GetI18nRequest.php           | 12 +++
 ...vision.php => PageWithRevisionRequest.php} |  2 +-
 src/DTO/Responses/Mobile/GetI18n.php          | 18 ++++
 src/DTO/Responses/Mobile/GetI18nMessage.php   | 84 +++++++++++++++++++
 src/DTO/Responses/Mobile/GetMobileLead.php    |  4 +-
 .../Responses/Mobile/GetMobileRemaining.php   |  4 +-
 ...obileSections.php => GetMobileSection.php} |  2 +-
 src/Resources/WikiMedia/MobileResource.php    | 23 ++++-
 tests/Resources/MobileResourceTest.php        | 10 +++
 10 files changed, 158 insertions(+), 10 deletions(-)
 create mode 100644 src/DTO/Requests/GetI18nRequest.php
 rename src/DTO/Requests/{PageRequestWithRevision.php => PageWithRevisionRequest.php} (73%)
 create mode 100644 src/DTO/Responses/Mobile/GetI18n.php
 create mode 100644 src/DTO/Responses/Mobile/GetI18nMessage.php
 rename src/DTO/Responses/Mobile/{GetMobileSections.php => GetMobileSection.php} (84%)

diff --git a/README.md b/README.md
index bf7c075..51c8a3c 100644
--- a/README.md
+++ b/README.md
@@ -82,6 +82,7 @@ COMMONS_HOST="https://commons.wikimedia.org/"
   * getSectionsLeadByRevision
   * getSectionsRemaining
   * getSectionsRemainingByRevision
+  * getI18n
 * feed - @ToDo
 * transforms - @ToDo
 * math - @ToDo
@@ -343,6 +344,14 @@ You can use this action for a typeahead search that automatically suggests relev
   $res = $wiki->mobile()->getSectionsRemainingByRevision($params);
 ```
 
+#### getI18n
+
+```php
+  $wiki = new MediaWiki();
+  $params = ['type' => 'pcs'];
+  $res = $wiki->mobile()->getI18n($params);
+```
+
 ## Request parameters validation
 
 For validation the package use `spatie/data-transfer-object` and `ekut/spatie-dto-validators`.
diff --git a/src/DTO/Requests/GetI18nRequest.php b/src/DTO/Requests/GetI18nRequest.php
new file mode 100644
index 0000000..c4f6965
--- /dev/null
+++ b/src/DTO/Requests/GetI18nRequest.php
@@ -0,0 +1,12 @@
+<?php
+
+namespace MediawikiSdkPhp\DTO\Requests;
+
+use Ekut\SpatieDtoValidators\Choice;
+use Spatie\DataTransferObject\DataTransferObject;
+
+class GetI18nRequest extends DataTransferObject
+{
+    #[Choice(['pcs'])]
+    public string $type;
+}
diff --git a/src/DTO/Requests/PageRequestWithRevision.php b/src/DTO/Requests/PageWithRevisionRequest.php
similarity index 73%
rename from src/DTO/Requests/PageRequestWithRevision.php
rename to src/DTO/Requests/PageWithRevisionRequest.php
index 9e7dd30..00dcff2 100644
--- a/src/DTO/Requests/PageRequestWithRevision.php
+++ b/src/DTO/Requests/PageWithRevisionRequest.php
@@ -5,7 +5,7 @@
 use Spatie\DataTransferObject\Attributes\Strict;
 
 #[Strict]
-class PageRequestWithRevision extends PageRequest
+class PageWithRevisionRequest extends PageRequest
 {
     public int $revision;
 }
diff --git a/src/DTO/Responses/Mobile/GetI18n.php b/src/DTO/Responses/Mobile/GetI18n.php
new file mode 100644
index 0000000..2886f19
--- /dev/null
+++ b/src/DTO/Responses/Mobile/GetI18n.php
@@ -0,0 +1,18 @@
+<?php
+
+namespace MediawikiSdkPhp\DTO\Responses\Mobile;
+
+use Spatie\DataTransferObject\Attributes\CastWith;
+use Spatie\DataTransferObject\Casters\ArrayCaster;
+use Spatie\DataTransferObject\DataTransferObject;
+
+class GetI18n extends DataTransferObject
+{
+    public string $locale;
+
+    /**
+     * @var GetI18nMessage[]
+     */
+    #[CastWith(ArrayCaster::class, itemType: GetI18nMessage::class)]
+    public array $messages;
+}
diff --git a/src/DTO/Responses/Mobile/GetI18nMessage.php b/src/DTO/Responses/Mobile/GetI18nMessage.php
new file mode 100644
index 0000000..8373417
--- /dev/null
+++ b/src/DTO/Responses/Mobile/GetI18nMessage.php
@@ -0,0 +1,84 @@
+<?php
+
+namespace MediawikiSdkPhp\DTO\Responses\Mobile;
+
+use Spatie\DataTransferObject\Attributes\MapFrom;
+use Spatie\DataTransferObject\DataTransferObject;
+
+class GetI18nMessage extends DataTransferObject
+{
+    #[MapFrom('description-add-link-title')]
+    public string $descriptionAddLinkTitle;
+    
+    #[MapFrom('article-read-more-title')]
+    public string $articleReadMoreTitle;
+    
+    #[MapFrom('table-title-other')]
+    public string $tableTitleOther;
+    
+    #[MapFrom('page-edit-history')]
+    public string $pageEditHistory;
+    
+    #[MapFrom('info-box-close-text')]
+    public string $infoBoxCloseText;
+    
+    #[MapFrom('page-talk-page-subtitle')]
+    public string $pageTalkPageSubtitle;
+    
+    #[MapFrom('page-issues-subtitle')]
+    public string $pageIssuesSubtitle;
+    
+    #[MapFrom('page-talk-page')]
+    public string $pageTalkPage;
+    
+    #[MapFrom('info-box-title')]
+    public string $infoBoxTitle;
+    
+    #[MapFrom('view-in-browser-footer-link')]
+    public string $viewInBrowserFooterLink;
+    
+    #[MapFrom('page-location')]
+    public string $pageLocation;
+    
+    #[MapFrom('page-similar-titles')]
+    public string $pageSimilarTitles;
+    
+    #[MapFrom('page-last-edited')]
+    public string $pageLastEdited;
+    
+    #[MapFrom('article-about-title')]
+    public string $articleAboutTitle;
+    
+    #[MapFrom('page-issues')]
+    public string $pageIssues;
+    
+    #[MapFrom('license-footer-name')]
+    public string $licenseFooterName;
+    
+    #[MapFrom('license-footer-text')]
+    public string $licenseFooterText;
+    
+    #[MapFrom('page-read-in-other-languages')]
+    public string $pageReadInOtherLanguages;
+    
+    #[MapFrom('article-edit-button')]
+    public string $articleEditButton;
+    
+    #[MapFrom('article-edit-protected-button')]
+    public string $articleEditProtectedButton;
+    
+    #[MapFrom('article-section-expand')]
+    public string $articleSectionExpand;
+    
+    #[MapFrom('article-section-collapse')]
+    public string $articleSectionCollapse;
+    
+    #[MapFrom('table-expand')]
+    public string $tableExpand;
+    
+    #[MapFrom('table-collapse')]
+    public string $tableCollapse;
+    
+    #[MapFrom('references-preview-header')]
+    public string $referencesPreviewHeader;
+}
diff --git a/src/DTO/Responses/Mobile/GetMobileLead.php b/src/DTO/Responses/Mobile/GetMobileLead.php
index 5907b3a..d820ae6 100644
--- a/src/DTO/Responses/Mobile/GetMobileLead.php
+++ b/src/DTO/Responses/Mobile/GetMobileLead.php
@@ -43,8 +43,8 @@ class GetMobileLead extends DataTransferObject
     public ?array $hatnotes;
 
     /**
-     * @var GetMobileSections[]
+     * @var GetMobileSection[]
      */
-    #[CastWith(ArrayCaster::class, itemType: GetMobileSections::class)]
+    #[CastWith(ArrayCaster::class, itemType: GetMobileSection::class)]
     public ?array $sections;
 }
diff --git a/src/DTO/Responses/Mobile/GetMobileRemaining.php b/src/DTO/Responses/Mobile/GetMobileRemaining.php
index 1453fda..dfd6911 100644
--- a/src/DTO/Responses/Mobile/GetMobileRemaining.php
+++ b/src/DTO/Responses/Mobile/GetMobileRemaining.php
@@ -9,8 +9,8 @@
 class GetMobileRemaining extends DataTransferObject
 {
     /**
-     * @var GetMobileSections[]
+     * @var GetMobileSection[]
      */
-    #[CastWith(ArrayCaster::class, itemType: GetMobileSections::class)]
+    #[CastWith(ArrayCaster::class, itemType: GetMobileSection::class)]
     public array $sections;
 }
diff --git a/src/DTO/Responses/Mobile/GetMobileSections.php b/src/DTO/Responses/Mobile/GetMobileSection.php
similarity index 84%
rename from src/DTO/Responses/Mobile/GetMobileSections.php
rename to src/DTO/Responses/Mobile/GetMobileSection.php
index 9df0717..3494fbf 100644
--- a/src/DTO/Responses/Mobile/GetMobileSections.php
+++ b/src/DTO/Responses/Mobile/GetMobileSection.php
@@ -4,7 +4,7 @@
 
 use Spatie\DataTransferObject\DataTransferObject;
 
-class GetMobileSections extends DataTransferObject
+class GetMobileSection extends DataTransferObject
 {
     public int $id;
 
diff --git a/src/Resources/WikiMedia/MobileResource.php b/src/Resources/WikiMedia/MobileResource.php
index d7689d6..9d3d965 100644
--- a/src/Resources/WikiMedia/MobileResource.php
+++ b/src/Resources/WikiMedia/MobileResource.php
@@ -3,8 +3,10 @@
 namespace MediawikiSdkPhp\Resources\WikiMedia;
 
 use JsonException;
+use MediawikiSdkPhp\DTO\Requests\GetI18nRequest;
 use MediawikiSdkPhp\DTO\Requests\PageRequest;
-use MediawikiSdkPhp\DTO\Requests\PageRequestWithRevision;
+use MediawikiSdkPhp\DTO\Requests\PageWithRevisionRequest;
+use MediawikiSdkPhp\DTO\Responses\Mobile\GetI18n;
 use MediawikiSdkPhp\DTO\Responses\Mobile\GetMobile;
 use MediawikiSdkPhp\DTO\Responses\Mobile\GetMobileLead;
 use MediawikiSdkPhp\DTO\Responses\Mobile\GetMobileRemaining;
@@ -32,7 +34,7 @@ public function getSections(array $params): mixed
      */
     public function getSectionsByRevision(array $params): mixed
     {
-        $this->validateParams(PageRequestWithRevision::class, $params);
+        $this->validateParams(PageWithRevisionRequest::class, $params);
 
         $url = "page/mobile-sections/{$params['title']}/{$params['revision']}";
 
@@ -58,7 +60,7 @@ public function getSectionsLead(array $params): mixed
      */
     public function getSectionsLeadByRevision(array $params): mixed
     {
-        $this->validateParams(PageRequestWithRevision::class, $params);
+        $this->validateParams(PageWithRevisionRequest::class, $params);
 
         $url = "page/mobile-sections-lead/{$params['title']}/{$params['revision']}";
 
@@ -84,10 +86,23 @@ public function getSectionsRemaining(array $params): mixed
      */
     public function getSectionsRemainingByRevision(array $params): mixed
     {
-        $this->validateParams(PageRequestWithRevision::class, $params);
+        $this->validateParams(PageWithRevisionRequest::class, $params);
 
         $url = "page/mobile-sections-remaining/{$params['title']}/{$params['revision']}";
 
         return $this->adapter->handle('get', $url, GetMobileRemaining::class);
     }
+
+    /**
+     * @throws MediaWikiException
+     * @throws JsonException
+     */
+    public function getI18n(array $params): mixed
+    {
+        $this->validateParams(GetI18nRequest::class, $params);
+
+        $url = "data/i18n/{$params['type']}";
+
+        return $this->adapter->handle('get', $url, GetI18n::class);
+    }
 }
diff --git a/tests/Resources/MobileResourceTest.php b/tests/Resources/MobileResourceTest.php
index c00c1a4..46f2158 100644
--- a/tests/Resources/MobileResourceTest.php
+++ b/tests/Resources/MobileResourceTest.php
@@ -2,6 +2,7 @@
 
 namespace Resources;
 
+use MediawikiSdkPhp\DTO\Responses\Mobile\GetI18n;
 use MediawikiSdkPhp\DTO\Responses\Mobile\GetMobile;
 use MediawikiSdkPhp\DTO\Responses\Mobile\GetMobileLead;
 use MediawikiSdkPhp\DTO\Responses\Mobile\GetMobileRemaining;
@@ -128,4 +129,13 @@ public function testGetSectionsRemainingByRevisionNotFound(): void
 
         $this->wiki->mobile()->getSectionsRemainingByRevision($params);
     }
+
+    public function testGetI18n(): void
+    {
+        $params = ['type' => 'pcs'];
+
+        $response = $this->wiki->mobile()->getI18n($params);
+
+        $this->assertInstanceOf(GetI18n::class, $response);
+    }
 }