Mark entire API as immutable and pure

Author: danog

src/DialogId.php

@@ -7,6 +7,8 @@
 /**
  * Represents the type of a bot API dialog ID.
  *
+ * @psalm-immutable
+ *
  * @api
  */
 enum DialogId
@@ -39,6 +41,8 @@ enum DialogId
     /**
      * Get the type of a dialog using just its bot API dialog ID.
      *
+     * @psalm-pure
+     *
      * @param integer $id Bot API ID.
      */
     public static function getType(int $id): self
@@ -61,6 +65,8 @@ public static function getType(int $id): self
 
     /**
      * Checks whether the provided bot API ID is a supergroup or channel ID.
+     *
+     * @psalm-pure
      */
     public static function isSupergroupOrChannel(int $id): bool
     {
@@ -69,20 +75,26 @@ public static function isSupergroupOrChannel(int $id): bool
 
     /**
      * Checks whether the provided bot API ID is a chat ID.
+     *
+     * @psalm-pure
      */
     public static function isChat(int $id): bool
     {
         return self::getType($id) === self::CHAT;
     }
     /**
      * Checks whether the provided bot API ID is a user ID.
+     *
+     * @psalm-pure
      */
     public static function isUser(int $id): bool
     {
         return self::getType($id) === self::USER;
     }
     /**
      * Checks whether the provided bot API ID is a secret chat ID.
+     *
+     * @psalm-pure
      */
     public static function isSecretChat(int $id): bool
     {
@@ -92,6 +104,8 @@ public static function isSecretChat(int $id): bool
     /**
      * Convert MTProto secret chat ID to bot API secret chat ID.
      *
+     * @psalm-pure
+     *
      * @param int $id MTProto secret chat ID
      *
      * @return int Bot API secret chat ID
@@ -108,6 +122,8 @@ public static function fromSecretChatId(int $id): int
     /**
      * Convert bot API secret chat ID to MTProto secret chat ID.
      *
+     * @psalm-pure
+     *
      * @param int $id Bot API secret chat ID
      *
      * @return int MTProto secret chat ID
@@ -124,6 +140,8 @@ public static function toSecretChatId(int $id): int
     /**
      * Convert MTProto channel ID to bot API channel ID.
      *
+     * @psalm-pure
+     *
      * @param int $id MTProto channel ID
      */
     public static function fromSupergroupOrChannelId(int $id): int
@@ -138,6 +156,8 @@ public static function fromSupergroupOrChannelId(int $id): int
     /**
      * Convert bot API channel ID to MTProto channel ID.
      *
+     * @psalm-pure
+     *
      * @param int $id Bot API channel ID
      */
     public static function toSupergroupOrChannelId(int $id): int
@@ -152,6 +172,8 @@ public static function toSupergroupOrChannelId(int $id): int
     /**
      * Convert MTProto chat ID to bot API chat ID.
      *
+     * @psalm-pure
+     *
      * @param int $id MTProto chat ID
      */
     public static function fromChatId(int $id): int
@@ -166,6 +188,8 @@ public static function fromChatId(int $id): int
     /**
      * Convert bot API chat ID to MTProto chat ID.
      *
+     * @psalm-pure
+     *
      * @param int $id Bot API chat ID
      */
     public static function toChatId(int $id): int
@@ -180,6 +204,8 @@ public static function toChatId(int $id): int
     /**
      * Convert MTProto user ID to bot API user ID.
      *
+     * @psalm-pure
+     *
      * @param int $id MTProto user ID
      */
     public static function fromUserId(int $id): int
@@ -193,6 +219,8 @@ public static function fromUserId(int $id): int
     /**
      * Convert bot API user ID to MTProto user ID.
      *
+     * @psalm-pure
+     *
      * @param int $id Bot API user ID
      */
     public static function toUserId(int $id): int