Added MessageStat & Attachments

Author: BushlanovDev

src/ModelFactory.php

@@ -5,11 +5,32 @@
 namespace BushlanovDev\MaxMessengerBot;
 
 use BushlanovDev\MaxMessengerBot\Enums\AttachmentType;
+use BushlanovDev\MaxMessengerBot\Enums\InlineButtonType;
 use BushlanovDev\MaxMessengerBot\Enums\MarkupType;
+use BushlanovDev\MaxMessengerBot\Enums\ReplyButtonType;
 use BushlanovDev\MaxMessengerBot\Enums\UpdateType;
 use BushlanovDev\MaxMessengerBot\Models\Attachments\AbstractAttachment;
+use BushlanovDev\MaxMessengerBot\Models\Attachments\AudioAttachment;
+use BushlanovDev\MaxMessengerBot\Models\Attachments\Buttons\Inline\AbstractInlineButton;
+use BushlanovDev\MaxMessengerBot\Models\Attachments\Buttons\Inline\CallbackButton;
+use BushlanovDev\MaxMessengerBot\Models\Attachments\Buttons\Inline\ChatButton;
+use BushlanovDev\MaxMessengerBot\Models\Attachments\Buttons\Inline\LinkButton;
+use BushlanovDev\MaxMessengerBot\Models\Attachments\Buttons\Inline\RequestContactButton;
+use BushlanovDev\MaxMessengerBot\Models\Attachments\Buttons\Inline\RequestGeoLocationButton;
+use BushlanovDev\MaxMessengerBot\Models\Attachments\Buttons\Reply\AbstractReplyButton;
+use BushlanovDev\MaxMessengerBot\Models\Attachments\Buttons\Reply\SendContactButton;
+use BushlanovDev\MaxMessengerBot\Models\Attachments\Buttons\Reply\SendGeoLocationButton;
+use BushlanovDev\MaxMessengerBot\Models\Attachments\Buttons\Reply\SendMessageButton;
+use BushlanovDev\MaxMessengerBot\Models\Attachments\ContactAttachment;
 use BushlanovDev\MaxMessengerBot\Models\Attachments\DataAttachment;
+use BushlanovDev\MaxMessengerBot\Models\Attachments\FileAttachment;
+use BushlanovDev\MaxMessengerBot\Models\Attachments\InlineKeyboardAttachment;
+use BushlanovDev\MaxMessengerBot\Models\Attachments\LocationAttachment;
+use BushlanovDev\MaxMessengerBot\Models\Attachments\PhotoAttachment;
+use BushlanovDev\MaxMessengerBot\Models\Attachments\ReplyKeyboardAttachment;
 use BushlanovDev\MaxMessengerBot\Models\Attachments\ShareAttachment;
+use BushlanovDev\MaxMessengerBot\Models\Attachments\StickerAttachment;
+use BushlanovDev\MaxMessengerBot\Models\Attachments\VideoAttachment;
 use BushlanovDev\MaxMessengerBot\Models\BotInfo;
 use BushlanovDev\MaxMessengerBot\Models\Chat;
 use BushlanovDev\MaxMessengerBot\Models\ChatList;
@@ -142,15 +163,80 @@ public function createMessage(array $data): Message
      */
     public function createAttachment(array $data): AbstractAttachment
     {
-        return match (AttachmentType::tryFrom($data['type'] ?? '')) {
+        $attachmentType = AttachmentType::tryFrom($data['type'] ?? '');
+        if ($attachmentType === AttachmentType::ReplyKeyboard
+            && isset($data['buttons']) && is_array($data['buttons'])) {
+            $data['buttons'] = array_map(
+                fn($rowOfButtons) => array_map([$this, 'createReplyButton'], $rowOfButtons),
+                $data['buttons'],
+            );
+        }
+
+        if ($attachmentType === AttachmentType::InlineKeyboard
+            && isset($data['payload']['buttons']) && is_array($data['payload']['buttons'])) {
+            $data['payload']['buttons'] = array_map(
+                fn($rowOfButtons) => array_map([$this, 'createInlineButton'], $rowOfButtons),
+                $data['payload']['buttons']
+            );
+        }
+
+        return match ($attachmentType) {
             AttachmentType::Data => DataAttachment::fromArray($data),
             AttachmentType::Share => ShareAttachment::fromArray($data),
+            AttachmentType::Image => PhotoAttachment::fromArray($data),
+            AttachmentType::Video => VideoAttachment::fromArray($data),
+            AttachmentType::Audio => AudioAttachment::fromArray($data),
+            AttachmentType::File => FileAttachment::fromArray($data),
+            AttachmentType::Sticker => StickerAttachment::fromArray($data),
+            AttachmentType::Contact => ContactAttachment::fromArray($data),
+            AttachmentType::InlineKeyboard => InlineKeyboardAttachment::fromArray($data),
+            AttachmentType::ReplyKeyboard => ReplyKeyboardAttachment::fromArray($data),
+            AttachmentType::Location => LocationAttachment::fromArray($data),
+            default => throw new LogicException("Unknown or unsupported attachment type: " . ($data['type'] ?? 'none')),
+        };
+    }
+
+    /**
+     * Creates a specific ReplyButton model based on the 'type' field.
+     *
+     * @param array<string, mixed> $data
+     *
+     * @return AbstractReplyButton
+     * @throws ReflectionException
+     * @throws LogicException
+     */
+    public function createReplyButton(array $data): AbstractReplyButton
+    {
+        return match (ReplyButtonType::tryFrom($data['type'] ?? '')) {
+            ReplyButtonType::Message => SendMessageButton::fromArray($data),
+            ReplyButtonType::UserContact => SendContactButton::fromArray($data),
+            ReplyButtonType::UserGeoLocation => SendGeoLocationButton::fromArray($data),
             default => throw new LogicException(
-                'Unknown or unsupported Attachment type: ' . ($data['type'] ?? 'none')
+                'Unknown or unsupported reply button type: ' . ($data['type'] ?? 'none')
             ),
         };
     }
 
+    /**
+     * Creates a specific InlineButton model based on the 'type' field.
+     *
+     * @param array<string, mixed> $data
+     * @return AbstractInlineButton
+     * @throws ReflectionException
+     * @throws LogicException
+     */
+    public function createInlineButton(array $data): AbstractInlineButton
+    {
+        return match (InlineButtonType::tryFrom($data['type'] ?? '')) {
+            InlineButtonType::Callback => CallbackButton::fromArray($data),
+            InlineButtonType::Link => LinkButton::fromArray($data),
+            InlineButtonType::RequestContact => RequestContactButton::fromArray($data),
+            InlineButtonType::RequestGeoLocation => RequestGeoLocationButton::fromArray($data),
+            InlineButtonType::Chat => ChatButton::fromArray($data),
+            default => throw new LogicException("Unknown or unsupported inline button type: " . ($data['type'] ?? 'none')),
+        };
+    }
+
     /**
      * List of messages.
      *

src/Models/AbstractModel.php

@@ -137,7 +137,7 @@ private static function castValue(mixed $value, ReflectionProperty $property): m
             return $typeName::from($value);
         }
 
-        if (is_subclass_of($typeName, self::class)) {
+        if (is_subclass_of($typeName, self::class) && is_array($value)) {
             return $typeName::fromArray($value);
         }
 

src/Models/Attachments/AudioAttachment.php

@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace BushlanovDev\MaxMessengerBot\Models\Attachments;
+
+use BushlanovDev\MaxMessengerBot\Enums\AttachmentType;
+use BushlanovDev\MaxMessengerBot\Models\Attachments\Payloads\MediaAttachmentPayload;
+
+final readonly class AudioAttachment extends AbstractAttachment
+{
+    /**
+     * @param MediaAttachmentPayload $payload Audio attachment payload.
+     * @param string|null $transcription Audio transcription.
+     */
+    public function __construct(
+        public MediaAttachmentPayload $payload,
+        public ?string $transcription,
+    ) {
+        parent::__construct(AttachmentType::Audio);
+    }
+}

src/Models/Attachments/ContactAttachment.php

@@ -0,0 +1,19 @@
+<?php
+
+declare(strict_types=1);
+
+namespace BushlanovDev\MaxMessengerBot\Models\Attachments;
+
+use BushlanovDev\MaxMessengerBot\Enums\AttachmentType;
+use BushlanovDev\MaxMessengerBot\Models\Attachments\Payloads\ContactAttachmentPayload;
+
+final readonly class ContactAttachment extends AbstractAttachment
+{
+    /**
+     * @param ContactAttachmentPayload $payload Contact attachment payload.
+     */
+    public function __construct(public ContactAttachmentPayload $payload)
+    {
+        parent::__construct(AttachmentType::Contact);
+    }
+}

src/Models/Attachments/FileAttachment.php

@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+namespace BushlanovDev\MaxMessengerBot\Models\Attachments;
+
+use BushlanovDev\MaxMessengerBot\Enums\AttachmentType;
+use BushlanovDev\MaxMessengerBot\Models\Attachments\Payloads\FileAttachmentPayload;
+
+final readonly class FileAttachment extends AbstractAttachment
+{
+    /**
+     * @param FileAttachmentPayload $payload File attachment payload.
+     * @param string $filename Uploaded file name.
+     * @param int $size File size in bytes.
+     */
+    public function __construct(
+        public FileAttachmentPayload $payload,
+        public string $filename,
+        public int $size,
+    ) {
+        parent::__construct(AttachmentType::File);
+    }
+}

src/Models/Attachments/InlineKeyboardAttachment.php

@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+
+namespace BushlanovDev\MaxMessengerBot\Models\Attachments;
+
+use BushlanovDev\MaxMessengerBot\Enums\AttachmentType;
+use BushlanovDev\MaxMessengerBot\Models\Attachments\Payloads\KeyboardPayload;
+
+final readonly class InlineKeyboardAttachment extends AbstractAttachment
+{
+    /**
+     * @param KeyboardPayload $payload Keyboard payload.
+     */
+    public function __construct(public KeyboardPayload $payload) {
+        parent::__construct(AttachmentType::InlineKeyboard);
+    }
+}

src/Models/Attachments/LocationAttachment.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace BushlanovDev\MaxMessengerBot\Models\Attachments;
+
+use BushlanovDev\MaxMessengerBot\Enums\AttachmentType;
+
+final readonly class LocationAttachment extends AbstractAttachment
+{
+    /**
+     * @param float $latitude
+     * @param float $longitude
+     */
+    public function __construct(
+        public float $latitude,
+        public float $longitude,
+    ) {
+        parent::__construct(AttachmentType::Location);
+    }
+}

src/Models/Attachments/Payloads/ContactAttachmentPayload.php

@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+namespace BushlanovDev\MaxMessengerBot\Models\Attachments\Payloads;
+
+use BushlanovDev\MaxMessengerBot\Models\AbstractModel;
+use BushlanovDev\MaxMessengerBot\Models\User;
+
+/**
+ * Payload of a contact attachment.
+ */
+final readonly class ContactAttachmentPayload extends AbstractModel
+{
+    /**
+     * @param string|null $vcfInfo User info in VCF format.
+     * @param User|null $maxInfo User info if the contact is a Max user.
+     */
+    public function __construct(
+        public ?string $vcfInfo,
+        public ?User $maxInfo,
+    ) {
+    }
+}

src/Models/Attachments/Payloads/FileAttachmentPayload.php

@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+namespace BushlanovDev\MaxMessengerBot\Models\Attachments\Payloads;
+
+use BushlanovDev\MaxMessengerBot\Models\AbstractModel;
+
+/**
+ * Payload for a file attachment.
+ */
+final readonly class FileAttachmentPayload extends AbstractModel
+{
+    /**
+     * @param string $url Media attachment URL.
+     * @param string $token Token to reuse the same attachment in other messages.
+     */
+    public function __construct(
+        public string $url,
+        public string $token,
+    ) {
+    }
+}

src/Models/Attachments/Payloads/KeyboardPayload.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace BushlanovDev\MaxMessengerBot\Models\Attachments\Payloads;
+
+use BushlanovDev\MaxMessengerBot\Models\AbstractModel;
+use BushlanovDev\MaxMessengerBot\Models\Attachments\Buttons\Inline\AbstractInlineButton;
+
+/**
+ * Represents an inline keyboard structure.
+ */
+final readonly class KeyboardPayload extends AbstractModel
+{
+    /**
+     * @param AbstractInlineButton[][] $buttons Two-dimensional array of buttons.
+     */
+    public function __construct(public array $buttons)
+    {
+    }
+}