Update api 9.4 9.5 2907373333873354482

API_9.3_FEATURES.md

@@ -0,0 +1,108 @@
+# ميزات Telegram Bot API 9.3 وكيفية استخدامها
+
+يقدم هذا الملف شرحاً للميزات الجديدة التي تم إضافتها في إصدار **Bot API 9.3** وكيفية الاستفادة منها عبر هذه المكتبة.
+
+## 1. المواضيع في المحادثات الخاصة (Topics in Private Chats)
+
+أصبح بإمكان البوتات الآن تفعيل نظام "المواضيع" (Topics) حتى في المحادثات الخاصة مع المستخدمين، مما يسمح بتنظيم المحادثة بشكل أفضل.
+
+### التحقق من تفعيل الميزة
+يمكنك معرفة ما إذا كان المستخدم قد فعل نظام المواضيع عبر حقل `has_topics_enabled` في كائن `User`:
+
+```php
+$user = $message->getFrom();
+if ($user->getHasTopicsEnabled()) {
+    // نظام المواضيع مفعل في هذه المحادثة الخاصة
+}
+```
+
+### إرسال رسالة إلى موضوع محدد
+تدعم جميع طرق الإرسال (مثل `sendMessage`, `sendPhoto`, إلخ) بارامتر `message_thread_id` لإرسال الرسالة إلى موضوع معين داخل المحادثة الخاصة:
+
+```php
+Request::sendMessage([
+    'chat_id'           => $user_id,
+    'text'              => 'رسالة داخل موضوع خاص',
+    'message_thread_id' => $thread_id,
+]);
+```
+
+---
+
+## 2. بث مسودة الرسالة (sendMessageDraft)
+
+تسمح هذه الطريقة الجديدة ببث أجزاء من الرسالة للمستخدم أثناء توليدها (مفيد جداً لبوتات الذكاء الاصطناعي).
+
+**ملاحظة:** هذه الميزة مدعومة حالياً فقط للبوتات التي فعلت نظام المواضيع (Forum Topic Mode).
+
+```php
+Request::sendMessageDraft([
+    'chat_id' => $user_id,
+    'text'    => 'جاري توليد الإجابة...',
+]);
+```
+
+---
+
+## 3. تحديثات الهدايا (Gifts)
+
+تم إضافة ميزات قوية للتعامل مع الهدايا العادية والفريدة (Unique Gifts).
+
+### الحصول على هدايا المستخدم أو الدردشة
+تم إضافة طرق جديدة لجلب قائمة الهدايا:
+
+```php
+// هدايا المستخدم
+$user_gifts = Request::getUserGifts(['user_id' => $user_id]);
+
+// هدايا الدردشة (القنوات)
+$chat_gifts = Request::getChatGifts(['chat_id' => $chat_id]);
+```
+
+### تحديثات الهدايا الفريدة (Unique Gift Info)
+تم استبدال حقل `last_resale_star_count` بحقول أكثر تفصيلاً:
+- `getLastResaleCurrency()`: العملة المستخدمة (مثل XTR أو TON).
+- `getLastResaleAmount()`: المبلغ المدفوع.
+
+---
+
+## 4. إعادة نشر القصص (repostStory)
+
+يمكن للبوتات الآن إعادة نشر القصص عبر حسابات الأعمال المختلفة التي تديرها.
+
+```php
+Request::repostStory([
+    'business_connection_id' => $connection_id,
+    'chat_id'                => $target_chat_id,
+    'story_id'               => $story_id,
+]);
+```
+
+---
+
+## 5. ميزات متنوعة
+
+### تأثيرات الرسائل (Message Effects)
+أصبح بإمكانك إضافة تأثيرات بصرية عند إعادة توجيه أو نسخ الرسائل باستخدام `message_effect_id`:
+
+```php
+Request::copyMessage([
+    'chat_id'           => $target_chat_id,
+    'from_chat_id'      => $source_chat_id,
+    'message_id'        => $message_id,
+    'message_effect_id' => '5104841245755180586', // مثال لمعرف تأثير
+]);
+```
+
+### تقييم المستخدم (User Rating)
+يمكن الحصول على تقييم المستخدم بناءً على إنفاقه لنجوم تلجرام عبر `ChatFullInfo`:
+
+```php
+$chat_info = Request::getChat(['chat_id' => $user_id])->getResult();
+$rating = $chat_info->getRating();
+echo "مستوى المستخدم: " . $rating->getLevel();
+```
+
+---
+
+للمزيد من التفاصيل حول كافة التغييرات، يرجى مراجعة [سجل تغييرات تلجرام الرسمي](https://core.telegram.org/bots/api-changelog#december-31-2025).

API_9.4_9.5_FEATURES.md

@@ -0,0 +1,133 @@
+# ميزات تحديث Bot API 9.4 و 9.5
+
+يدعم هذا الإصدار من المكتبة ميزات تحديث Telegram Bot API 9.4 و 9.5. فيما يلي الميزات الجديدة وكيفية استخدامها.
+
+## Bot API 9.5
+
+### 1. الكيان الجديد `date_time` في الرسائل
+تم إضافة نوع جديد للكيانات `MessageEntity` يسمى `date_time` لعرض التاريخ والوقت بتنسيق محدد للمستخدم.
+
+```php
+// مثال على تنسيق التاريخ والوقت في MarkdownV2
+$text = "موعد الاجتماع: ![22:45 tomorrow](tg://time?unix=1740861900&format=wDT)";
+
+Request::sendMessage([
+    'chat_id'    => $chat_id,
+    'text'       => $text,
+    'parse_mode' => 'MarkdownV2',
+]);
+```
+
+### 2. ميزة بث الرسائل الجاري إنشاؤها (`sendMessageDraft`)
+أصبح بإمكان جميع البوتات الآن استخدام الطريقة `sendMessageDraft` لبث أجزاء من الرسالة للمستخدم أثناء إنشائها (مثل تطبيقات الذكاء الاصطناعي).
+
+```php
+Request::sendMessageDraft([
+    'chat_id'  => $chat_id,
+    'draft_id' => 12345, // معرف فريد للمسودة
+    'text'     => "جاري التفكير...",
+]);
+
+// تحديث النص (سيظهر بحركة أنيميشن)
+Request::sendMessageDraft([
+    'chat_id'  => $chat_id,
+    'draft_id' => 12345,
+    'text'     => "جاري التفكير... لقد وجدت الحل!",
+]);
+
+// إرسال الرسالة النهائية باستخدام sendMessage العادي
+```
+
+### 3. وسوم الأعضاء (Member Tags) وأذونات جديدة
+تم إضافة حقل `tag` للأعضاء العاديين، وطريقة `setChatMemberTag` لتعيينها، بالإضافة إلى أذونات التحكم بها.
+
+```php
+// تعيين وسم لعضو
+Request::setChatMemberTag([
+    'chat_id' => $chat_id,
+    'user_id' => $user_id,
+    'tag'     => "مميز",
+]);
+```
+
+الأذونات الجديدة:
+- `can_edit_tag`: يسمح للمستخدم بتعديل وسمه الخاص.
+- `can_manage_tags`: يسمح للمشرفين بتعديل وسوم الأعضاء.
+
+---
+
+## Bot API 9.4
+
+### 1. المواضيع (Topics) في الدردشات الخاصة
+أصبح بإمكان البوتات إنشاء مواضيع في الدردشات الخاصة مع المستخدمين، تماماً كما في المجموعات الكبيرة.
+
+```php
+// إنشاء موضوع في دردشة خاصة
+Request::createForumTopic([
+    'chat_id' => $user_id,
+    'name'    => "الدعم الفني",
+]);
+```
+
+### 2. أزرار ملونة ورموز تعبيرية مخصصة
+يمكن الآن تغيير لون الأزرار وإضافة رموز تعبيرية مخصصة لها.
+
+```php
+$keyboard = new InlineKeyboard([
+    ['text' => 'حذف', 'callback_data' => 'delete', 'style' => 'danger'], // زر أحمر
+    ['text' => 'تأكيد', 'callback_data' => 'ok', 'style' => 'success'],  // زر أخضر
+    ['text' => 'معلومات', 'callback_data' => 'info', 'style' => 'primary'], // زر أزرق
+]);
+
+$keyboard_with_emoji = new Keyboard([
+    ['text' => 'الإعدادات', 'icon_custom_emoji_id' => '5368324170671202286'],
+]);
+```
+
+### 3. إدارة صورة الملف الشخصي للبوت
+طرق جديدة لتعيين أو حذف صورة البوت الشخصية مباشرة عبر API.
+
+```php
+Request::setMyProfilePhoto([
+    'photo' => '/path/to/photo.jpg',
+]);
+
+Request::removeMyProfilePhoto();
+```
+
+### 4. جودة الفيديو ووسائط الملف الشخصي
+- `VideoQuality`: الحصول على معلومات حول الجودات المتاحة للفيديو.
+- `first_profile_audio`: الحصول على أول ملف صوتي في ملف تعريف المستخدم (للحسابات المميزة).
+- `getUserProfileAudios`: جلب قائمة الملفات الصوتية في ملف تعريف المستخدم.
+
+```php
+$response = Request::getUserProfileAudios(['user_id' => $user_id]);
+if ($response->isOk()) {
+    $audios = $response->getResult()->getAudios();
+}
+```
+
+- `first_profile_audio`: في كائن `ChatFullInfo` (للدردشات الخاصة)، يمثل أول ملف صوتي في ملف تعريف المستخدم.
+
+```php
+// جلب أول صوت في الملف الشخصي من معلومات الدردشة الكاملة
+$chat_info = Request::getChat(['chat_id' => $user_id])->getResult();
+$first_audio = $chat_info->getFirstProfileAudio();
+```
+
+### 5. زر الدردشة السفلي (Chat Bottom Button)
+تم إضافة دعم لتعيين زر في أسفل الدردشة يفتح تطبيق ويب (Mini App).
+
+```php
+Request::setChatBottomButton([
+    'chat_id' => $chat_id,
+    'bottom_button' => [
+        'text' => 'فتح المتجر',
+        'web_app' => ['url' => 'https://example.com/shop'],
+    ],
+]);
+```
+
+### 6. ميزات الهدايا (Gifts)
+- إضافة حقل `rarity` لنماذج الهدايا الفريدة (`UniqueGiftModel`).
+- إضافة حقل `is_burned` للهدايا الفريدة (`UniqueGift`) التي تم استخدامها في نظام الصياغة (Crafting).

CHANGELOG.md

@@ -6,8 +6,85 @@ Exclamation symbols (:exclamation:) note something of importance e.g. breaking c
 ## [Unreleased]
 ### Notes
 - [:ledger: View file changes][Unreleased]
+
+## [1.2.0] - 2026-03-01
+### Notes
+- [:ledger: View file changes][1.2.0]
+- [API 9.4 and 9.5 Features Documentation](API_9.4_9.5_FEATURES.md)
+- [API 9.3 Features Documentation](API_9.3_FEATURES.md)
+- Support for Telegram Bot API 7.4 through 9.5.
+### Added
+- **Bot API 9.5:**
+    - New `MessageEntity` type `date_time` with `unix_time` and `date_time_format`.
+    - Support for `sendMessageDraft` for all bots.
+    - Member tags support in `ChatMemberMember`, `ChatMemberRestricted`, and `setChatMemberTag`.
+    - New permissions `can_edit_tag` and `can_manage_tags`.
+- **Bot API 9.4:**
+    - Topics in private chats via `createForumTopic`.
+    - Colored and custom emoji buttons (`KeyboardButton` and `InlineKeyboardButton`).
+    - Bot profile photo management (`setMyProfilePhoto`, `removeMyProfilePhoto`).
+    - Enhanced video and audio metadata (`VideoQuality`, `UserProfileAudios`, `first_profile_audio`).
+- **Private Chat Topics:** Support for forum topics in private chats.
+- **Message Streaming:** Added `sendMessageDraft` for streaming partial messages.
+- **Gifts Enhancement:** Added `getUserGifts`, `getChatGifts`, and support for Unique Gifts with colors and blockchain info.
+- **Business Accounts:** Complete support for managed business accounts, including story reposting, checklist management, and profile settings.
+- **Telegram Stars:** Full support for Star transactions, subscriptions, and affiliate programs.
+- **Channel Direct Messages:** Support for direct messages in channels and suggested posts.
+- **New Entities:** `VideoQuality`, `UserRating`, `AffiliateInfo`, `StarTransaction`, `PaidMediaPurchased`, `PreparedInlineMessage`, `WebAppUser`, `ChatOwnerLeft`, `ChatOwnerChanged`, `UserProfileAudios`.
+- **New Request Methods:** `repostStory`, `verifyUser`, `verifyChat`, `removeUserVerification`, `removeChatVerification`, `createChatSubscriptionInviteLink`, `editChatSubscriptionInviteLink`, `editUserStarSubscription`, `refundStarPayment`, `savePreparedInlineMessage`.
+### Changed
+- Updated `User`, `Message`, `Chat`, `ChatFullInfo`, `Poll`, `InlineKeyboardButton`, `KeyboardButton`, and many other entities with new fields.
+- Replaced `last_resale_star_count` with `last_resale_currency` and `last_resale_amount` in `UniqueGiftInfo`.
+### Deprecated
+### Removed
+- Deprecated `hide_url` from `InlineQueryResultArticle`.
+- Replaced fields in `UniqueGiftInfo` as per API 9.3.
+### Fixed
+### Security
+
+## [1.0.3] - 2024-05-07
+### Notes
+- [:ledger: View file changes][1.0.3]
+- Support for Telegram Bot API 7.3.
+### Added
+- **Poll Enhancements:**
+    - New entity `InputPollOption` (`src/Entities/Poll/InputPollOption.php`) with properties `text` and optional `text_entities`.
+    - Added optional property `question_entities` (array of `MessageEntity`) to `src/Entities/Poll.php`.
+    - Added optional property `text_entities` (array of `MessageEntity`) to `src/Entities/PollOption.php`.
+    - Updated `sendPoll` method in `src/Request.php`:
+        - Changed `options` parameter to be an array of `InputPollOption`.
+        - Added optional parameters `question_parse_mode` (string) and `question_entities` (array of `MessageEntity`).
+- **Chat and getChat Method Refactoring:**
+    - New entity `ChatFullInfo` (`src/Entities/ChatFullInfo.php`) containing all properties from `Chat` entity plus properties from `getChat` (e.g., `description`, `invite_link`, `pinned_message`, `bio`) and new optional property `max_reaction_count` (integer).
+    - Updated `getChat` method in `src/Request.php` docblock to return a `ServerResponse` with a `ChatFullInfo` object.
+- **Miscellaneous Updates:**
+    - New Chat Background entities:
+        - `src/Entities/ChatBackground.php`
+        - `src/Entities/Background/BackgroundType.php`
+        - `src/Entities/Background/BackgroundFill.php`
+    - Added optional property `chat_background_set` (`ChatBackground`) to `src/Entities/Message.php`.
+    - Added optional property `via_join_request` (boolean) to `src/Entities/ChatMemberUpdated.php`.
+    - Added optional parameter `live_period` (integer) to `editMessageLiveLocation` method in `src/Request.php`.
+### Changed
+- Version bumped to 1.0.3.
+### Deprecated
+### Removed
+### Fixed
+### Security
+
+## [1.0.2] - 2025-07-04
+### Notes
+- [:ledger: View file changes][1.0.2]
+- Support for Telegram Bot API 7.2.
 ### Added
+- Bot API 7.2 support. This includes:
+    - Business Account Integration (New entities: `BusinessConnection`, `BusinessMessagesDeleted`; Updated `Update.php`, `Request.php`, `Message.php`)
+    - Business Information Entities (New entities: `BusinessIntro`, `BusinessLocation`, `BusinessOpeningHours`, `BusinessOpeningHoursInterval`; Updated `Chat.php`)
+    - Sticker Pack Modifications (Updated `StickerSet.php`, `InputSticker.php`, `Request.php`)
+    - Request & Shared Object Improvements (New entity: `SharedUser`; Updated `KeyboardButtonRequestUsers.php`, `KeyboardButtonRequestChat.php`, `UsersShared.php`, `ChatShared.php`)
+    - Miscellaneous Changes (New entity: `Birthdate`; Updated `Chat.php`, `Message.php`, `User.php`)
 ### Changed
+- Version bumped to 1.0.2.
 ### Deprecated
 ### Removed
 ### Fixed
@@ -694,7 +771,10 @@ Exclamation symbols (:exclamation:) note something of importance e.g. breaking c
 [PSR-3]: https://www.php-fig.org/psr/psr-3
 [Tidelift]: https://tidelift.com/subscription/pkg/packagist-longman-telegram-bot?utm_source=packagist-longman-telegram-bot&utm_medium=referral&utm_campaign=changelog
 
-[Unreleased]: https://github.com/php-telegram-bot/core/compare/master...develop
+[Unreleased]: https://github.com/php-telegram-bot/core/compare/1.2.0...develop
+[1.2.0]: https://github.com/php-telegram-bot/core/compare/1.0.3...1.2.0
+[1.0.3]: https://github.com/php-telegram-bot/core/compare/1.0.2...1.0.3
+[1.0.2]: https://github.com/php-telegram-bot/core/compare/0.83.0...1.0.2
 [0.83.0]: https://github.com/php-telegram-bot/core/compare/0.82.0...0.83.0
 [0.82.0]: https://github.com/php-telegram-bot/core/compare/0.81.0...0.82.0
 [0.81.0]: https://github.com/php-telegram-bot/core/compare/0.80.0...0.81.0