Merge pull request #251 from defstudio/implement_getUserProfilePhotos

Implement get user profile photos

docs/content/en/features/telegram-api-calls.md

@@ -327,6 +327,14 @@ retrieves Chat member count
 Telegraph::chatMemberCount()->send();
 ```
 
+## userProfilePhotos
+
+retrieves the User's profile photos
+
+```php
+Telegraph::userProfilePhotos($userId)->send();
+```
+
 ## generateChatPrimaryInviteLink
 
 generates a new primary invite link for a chat. Any previously generated primary link is revoked. For more info, see telegram [bot documentation](https://core.telegram.org/bots/api#exportchatinvitelink)

src/Concerns/InteractWithUsers.php

@@ -0,0 +1,25 @@
+<?php
+
+
+/** @noinspection PhpUnhandledExceptionInspection */
+
+namespace DefStudio\Telegraph\Concerns;
+
+use DefStudio\Telegraph\Telegraph;
+
+/**
+ * @mixin Telegraph
+ */
+
+trait InteractWithUsers
+{
+    public function userProfilePhotos(string $userId): Telegraph
+    {
+        $telegraph = clone $this;
+
+        $telegraph->endpoint = self::ENDPOINT_GET_USER_PROFILE_PHOTOS;
+        $telegraph->data['user_id'] = $userId;
+
+        return $telegraph;
+    }
+}

src/Facades/Telegraph.php

@@ -57,6 +57,7 @@
  * @method static \DefStudio\Telegraph\Telegraph  restrictChatMember(string $userId, array $permissions)
  * @method static \DefStudio\Telegraph\Telegraph  promoteChatMember(string $userId, array $permissions)
  * @method static \DefStudio\Telegraph\Telegraph  demoteChatMember(string $userId)
+ * @method static \DefStudio\Telegraph\Telegraph  userProfilePhotos(string $userId)
  * @method static TelegraphPollPayload poll(string $question)
  * @method static TelegraphQuizPayload quiz(string $question)
  * @method static string store(Downloadable $attachment, string $path, string $filename = null)

src/Telegraph.php

@@ -15,6 +15,7 @@
 use DefStudio\Telegraph\Concerns\HasBotsAndChats;
 use DefStudio\Telegraph\Concerns\InteractsWithTelegram;
 use DefStudio\Telegraph\Concerns\InteractsWithWebhooks;
+use DefStudio\Telegraph\Concerns\InteractWithUsers;
 use DefStudio\Telegraph\Concerns\ManagesKeyboards;
 use DefStudio\Telegraph\Concerns\SendsAttachments;
 use DefStudio\Telegraph\Concerns\StoresFiles;
@@ -34,6 +35,7 @@ class Telegraph
     use StoresFiles;
     use AnswersInlineQueries;
     use CreatesScopedPayloads;
+    use InteractWithUsers;
 
     public const MAX_DOCUMENT_SIZE_IN_MB = 50;
     public const MAX_PHOTO_SIZE_IN_MB = 10;
@@ -92,6 +94,7 @@ class Telegraph
     public const ENDPOINT_PROMOTE_CHAT_MEMBER = 'promoteChatMember';
     public const ENDPOINT_SEND_POLL = 'sendPoll';
     public const ENDPOINT_FORWARD_MESSAGE = 'forwardMessage';
+    public const ENDPOINT_GET_USER_PROFILE_PHOTOS = 'getUserProfilePhotos';
 
 
     /** @var array<string, mixed> */

tests/Unit/Concerns/InteractsWithUsersTest.php

@@ -0,0 +1,11 @@
+<?php
+
+/** @noinspection PhpUnhandledExceptionInspection */
+
+/** @noinspection LaravelFunctionsInspection */
+
+it('can retrieve user profile photos', function () {
+    expect(function (\DefStudio\Telegraph\Telegraph $telegraph) {
+        return $telegraph->chat(make_chat())->userProfilePhotos(123456);
+    })->toMatchTelegramSnapshot();
+});

tests/__snapshots__/InteractsWithUsersTest__it_can_retrieve_user_profile_photos__1.yml

@@ -0,0 +1,4 @@
+url: 'https://api.telegram.org/bot3f3814e1-5836-3d77-904e-60f64b15df36/getUserProfilePhotos'
+payload:
+    user_id: '123456'
+files: {  }