Merge pull request #1181 from discord-php/feat-reactions-fetch

Add reactions::fetch()

Author: SQKo

src/Discord/Parts/Channel/Reaction.php

@@ -16,8 +16,10 @@
 use Discord\Parts\Guild\Emoji;
 use Discord\Parts\Guild\Guild;
 use Discord\Parts\Part;
+use Discord\Parts\Thread\Thread;
 use Discord\Parts\User\User;
 use React\Promise\ExtendedPromiseInterface;
+use stdClass;
 use Symfony\Component\OptionsResolver\OptionsResolver;
 
 use function Discord\normalizePartId;
@@ -49,6 +51,7 @@ class Reaction extends Part
      * {@inheritDoc}
      */
     protected $fillable = [
+        'id', // internal
         'count',
         'me',
         'emoji',
@@ -80,6 +83,42 @@ public function fetch(): ExtendedPromiseInterface
             });
     }
 
+    /**
+     * Sets the emoji identifier.
+     *
+     * @internal Used for ReactionRepository::fetch()
+     *
+     * @param string $value name:id or the character of standard emoji
+     *
+     * @return void
+     *
+     * @since 10.0.0
+     */
+    protected function setIdAttribute(string $value): void
+    {
+        if (! isset($this->attributes['emoji'])) {
+            $this->attributes['emoji'] = new stdClass;
+        }
+
+        $colonDelimiter = explode(':', $value);
+        $delimitedCount = count($colonDelimiter);
+        $emojiId = $emojiAnimated = null;
+
+        if ($delimitedCount == 2) { // Custom emoji name:id
+            [$emojiName, $emojiId] = $colonDelimiter;
+        } elseif ($delimitedCount == 3) { // Custom animated emoji a:name:id
+            [$emojiAnimated, $emojiName, $emojiId] = $colonDelimiter;
+        } else { // Standard emoji (or just have abnormal colon count)
+            $emojiName = $value;
+        }
+
+        $this->attributes['emoji']->id = $emojiId;
+        $this->attributes['emoji']->name = $emojiName;
+        if ($emojiAnimated == 'a') {
+            $this->attributes['emoji']->animated = true;
+        }
+    }
+
     /**
      * Gets the emoji identifier.
      *
@@ -101,7 +140,7 @@ protected function getIdAttribute(): string
      *
      * @link https://discord.com/developers/docs/resources/channel#get-reactions
      *
-     * @return ExtendedPromiseInterface<Collection|Users[]>
+     * @return ExtendedPromiseInterface<Collection|User[]>
      */
     public function getUsers(array $options = []): ExtendedPromiseInterface
     {
@@ -144,7 +183,7 @@ public function getUsers(array $options = []): ExtendedPromiseInterface
      *
      * @see Message::getUsers()
      *
-     * @return ExtendedPromiseInterface<Collection|Users[]>
+     * @return ExtendedPromiseInterface<Collection|User[]>
      */
     public function getAllUsers(): ExtendedPromiseInterface
     {

src/Discord/Repository/Channel/ReactionRepository.php

@@ -36,6 +36,7 @@ class ReactionRepository extends AbstractRepository
      * {@inheritDoc}
      */
     protected $endpoints = [
+        'get' => Endpoint::MESSAGE_REACTION_EMOJI,
         'delete' => Endpoint::MESSAGE_REACTION_EMOJI,
     ];