Part::save() (#1426)

Author: valzargaming

src/Discord/Builders/MessageBuilder.php

@@ -431,7 +431,6 @@ public function getForward(): ?Message
      */
     public function addComponent(ComponentObject $component): self
     {
-
         /*
         if (! in_array($component::USAGE, ['Message'])) {
             throw new \InvalidArgumentException('Invalid component type for messages.');

src/Discord/Discord.php

@@ -109,7 +109,7 @@ class Discord
      *
      * @var string Version.
      */
-    public const VERSION = 'v10.37.4';
+    public const VERSION = 'v10.38.0';
 
     public const REFERRER = 'https://github.com/discord-php/DiscordPHP';
 

src/Discord/DiscordCommandClient.php

@@ -79,7 +79,7 @@ public function __construct(array $options = [])
                 }
 
                 if ($withoutPrefix = $this->checkForPrefix($message->content)) {
-                    $args = str_getcsv($withoutPrefix, ' ', '"', "\\");
+                    $args = str_getcsv($withoutPrefix, ' ', '"', '\\');
                     $command = array_shift($args);
 
                     if (null !== $command && $this->commandClientOptions['caseInsensitiveCommands']) {

src/Discord/Parts/Channel/Channel.php

@@ -24,14 +24,15 @@
 use Discord\Parts\User\User;
 use Discord\Repository\Channel\MessageRepository;
 use Discord\Repository\Channel\OverwriteRepository;
-use Discord\Repository\Channel\VoiceMemberRepository as MemberRepository;
 use Discord\Repository\Channel\WebhookRepository;
 use Discord\Helpers\Multipart;
 use Discord\Http\Endpoint;
 use Discord\Http\Exceptions\NoPermissionsException;
 use Discord\Parts\Channel\Forum\Reaction;
 use Discord\Parts\Channel\Forum\Tag;
+use Discord\Parts\Guild\Guild;
 use Discord\Parts\Thread\Thread;
+use Discord\Parts\WebSockets\VoiceStateUpdate;
 use Discord\Repository\Channel\InviteRepository;
 use Discord\Repository\Channel\StageInstanceRepository;
 use Discord\Repository\Channel\ThreadRepository;
@@ -194,7 +195,6 @@ class Channel extends Part implements Stringable
      */
     protected $repositories = [
         'overwrites' => OverwriteRepository::class,
-        'members' => MemberRepository::class,
         'messages' => MessageRepository::class,
         'webhooks' => WebhookRepository::class,
         'threads' => ThreadRepository::class,
@@ -997,6 +997,21 @@ public function startThread(array|string $options, string|bool|null $reason = nu
             return $threadPart;
         });
     }
+
+    /**
+     * Gets the members currently in the voice channel.
+     *
+     * @return ExCollectionInterface<VoiceStateUpdate>|VoiceStateUpdate[] Members in the voice channel.
+     */
+    public function getMembersAttribute(): ExCollectionInterface
+    {
+        if ($guild = $this->guild) {
+            return $guild->voice_states->filter(fn (VoiceStateUpdate $voice_state) => $voice_state->channel_id === $this->id);
+        }
+
+        return Collection::for(VoiceStateUpdate::class, 'user_id');
+    }
+
     /**
      * @inheritDoc
      *
@@ -1168,6 +1183,28 @@ public function getUpdatableAttributes(): array
         return $attr;
     }
 
+    /**
+     * @inheritDoc
+     */
+    public function save(?string $reason = null): PromiseInterface
+    {
+        if (isset($this->attributes['guild_id'])) {
+            if ($botperms = $this->getBotPermissions()) {
+                if (! $botperms->manage_channels) {
+                    return reject(new NoPermissionsException("You do not have permission to manage channels in the guild {$this->attributes['guild_id']}."));
+                }
+            }
+            /** @var Guild $guild */
+            $guild = $this->guild ?? $this->factory->part(Guild::class, ['id' => $this->attributes['guild_id']], true);
+
+            return $guild->channels->save($this, $reason);
+        } elseif ($this->created && $this->discord->private_channels->get('id', $this->id)) {
+            return $this->discord->private_channels->save($this, $reason);
+        }
+
+        return parent::save($reason);
+    }
+
     /**
      * @inheritDoc
      */

src/Discord/Parts/Channel/Invite.php

@@ -14,14 +14,18 @@
 namespace Discord\Parts\Channel;
 
 use Carbon\Carbon;
+use Discord\Http\Exceptions\NoPermissionsException;
 use Discord\Parts\Guild\Guild;
 use Discord\Parts\Guild\Profile;
 use Discord\Parts\Guild\ScheduledEvent;
 use Discord\Parts\OAuth\Application;
 use Discord\Parts\Part;
 use Discord\Parts\User\User;
+use React\Promise\PromiseInterface;
 use Stringable;
 
+use function React\Promise\reject;
+
 /**
  * An invite to a Channel and Guild.
  *
@@ -117,9 +121,11 @@ protected function getIdAttribute(): string
      */
     protected function getGuildAttribute(): ?Guild
     {
-        $guildId = $this->guild_id;
+        if (! isset($this->attributes['guild_id'])) {
+            return null;
+        }
 
-        if ($guildId && $guild = $this->discord->guilds->get('id', $guildId)) {
+        if ($guild = $this->discord->guilds->get('id', $this->attributes['guild_id'])) {
             return $guild;
         }
 
@@ -308,6 +314,26 @@ protected function getInviteUrlAttribute(): string
         return 'https://discord.gg/'.$this->code;
     }
 
+    /**
+     * @inheritDoc
+     */
+    public function save(?string $reason = null): PromiseInterface
+    {
+        if (isset($this->attributes['channel_id'])) {
+            /** @var Channel $channel */
+            $channel = $this->channel ?? $this->factory->part(Channel::class, ['id' => $this->attributes['channel_id']], true);
+            if ($botperms = $channel->getBotPermissions()) {
+                if (! $botperms->create_instant_invite) {
+                    return reject(new NoPermissionsException("You do not have permission to create invites in the channel {$channel->id}."));
+                }
+            }
+
+            return $channel->invites->save($this, $reason);
+        }
+
+        return parent::save();
+    }
+
     /**
      * @inheritDoc
      */

src/Discord/Parts/Channel/Message.php

@@ -1387,6 +1387,41 @@ public function getUpdatableAttributes(): array
         ];
     }
 
+    /**
+     * @inheritDoc
+     */
+    public function save(?string $reason = null): PromiseInterface
+    {
+        if (isset($this->attributes['channel_id'])) {
+            /** @var Channel $channel */
+            $channel = $this->channel ?? $this->factory->part(Channel::class, ['id' => $this->attributes['channel_id']], true);
+
+            if ($botperms = $channel->getBotPermissions()) {
+                if (! $this->created) {
+                    if (! $botperms->send_messages) {
+                        return reject(new NoPermissionsException("You do not have permission to send messages in channel {$channel->id}."));
+                    }
+                }
+                if (! $botperms->manage_messages) {
+                    return reject(new NoPermissionsException("You do not have permission to manage messages in channel {$channel->id}."));
+                }
+            }
+
+            if (isset($this->attributes['webhook_id'])) {
+                if (! $webhook = $channel->webhooks->get('id', $this->attributes['webhook_id'])) {
+                    return reject(new \Exception('Cannot find the webhook for this message (missing token).'));
+                }
+
+                return $webhook->messages->save($this, $reason);
+            }
+
+            /** @var Channel $channel */
+            return $channel->messages->save($this, $reason);
+        }
+
+        return parent::save();
+    }
+
     /**
      * @inheritDoc
      */

src/Discord/Parts/Channel/StageInstance.php

@@ -13,8 +13,12 @@
 
 namespace Discord\Parts\Channel;
 
+use Discord\Http\Exceptions\NoPermissionsException;
 use Discord\Parts\Guild\Guild;
 use Discord\Parts\Part;
+use React\Promise\PromiseInterface;
+
+use function React\Promise\reject;
 
 /**
  * A Stage Instance holds information about a live stage.
@@ -120,6 +124,26 @@ public function getUpdatableAttributes(): array
         ]);
     }
 
+    /**
+     * @inheritDoc
+     */
+    public function save(?string $reason = null): PromiseInterface
+    {
+        if (isset($this->attributes['channel_id'])) {
+            /** @var Channel $channel */
+            $channel = $this->channel ?? $this->factory->part(Channel::class, ['id' => $this->channel_id], true);
+            if ($botperms = $channel->getBotPermissions()) {
+                if ($botperms->manage_channels && $botperms->mute_members && $botperms->move_members) {
+                    return reject(new NoPermissionsException("You do not have permission to moderate members in the channel {$channel->id}."));
+                }
+            }
+
+            return $channel->stage_instances->save($this, $reason);
+        }
+
+        return parent::save();
+    }
+
     /**
      * @inheritDoc
      */

src/Discord/Parts/Channel/Webhook.php

@@ -24,8 +24,9 @@
 use Symfony\Component\OptionsResolver\OptionsResolver;
 
 /**
- * Webhooks are a low-effort way to post messages to channels in Discord. They
- * do not require a bot user or authentication to use.
+ * Webhooks are a low-effort way to post messages to channels in Discord. They do not require a bot user or authentication to use.
+ *
+ * Apps can also subscribe to webhook events (i.e. outgoing webhooks) when events happen in Discord, which is detailed in the Webhook Events documentation.
  *
  * @link https://discord.com/developers/docs/resources/webhook#webhook-resource
  *
@@ -375,6 +376,16 @@ public function getUpdatableAttributes(): array
         ]);
     }
 
+    /**
+     * @inheritDoc
+     */
+    public function save(?string $reason = null): PromiseInterface
+    {
+        $channel = $this->channel ?? $this->factory->part(Channel::class, ['id' => $this->channel_id], true);
+
+        return $channel->webhooks->save($this, $reason);
+    }
+
     /**
      * @inheritDoc
      */

src/Discord/Parts/Guild/AutoModeration/Rule.php

@@ -20,6 +20,7 @@
 use Discord\Parts\Guild\Role;
 use Discord\Parts\Part;
 use Discord\Parts\User\User;
+use React\Promise\PromiseInterface;
 
 /**
  * Auto Moderation is a feature which allows each guild to set up rules that
@@ -229,6 +230,21 @@ public function getUpdatableAttributes(): array
         return $attr;
     }
 
+    /**
+     * @inheritDoc
+     */
+    public function save(?string $reason = null): PromiseInterface
+    {
+        if (isset($this->attributes['guild_id'])) {
+            /** @var Guild $guild */
+            $guild = $this->guild ?? $this->factory->part(Guild::class, ['id' => $this->attributes['guild_id']], true);
+
+            return $guild->autoModerationRules->save($this, $reason);
+        }
+
+        return parent::save();
+    }
+
     /**
      * @inheritDoc
      */

src/Discord/Parts/Guild/Ban.php

@@ -15,6 +15,9 @@
 
 use Discord\Parts\Part;
 use Discord\Parts\User\User;
+use React\Promise\PromiseInterface;
+
+use function React\Promise\reject;
 
 /**
  * A Ban is a ban on a user specific to a guild. It is also IP based.
@@ -88,6 +91,26 @@ protected function getUserAttribute(): User
         return $this->attributePartHelper('user', User::class);
     }
 
+    /**
+     * @inheritDoc
+     */
+    public function save(?string $reason = null): PromiseInterface
+    {
+        if (isset($this->attributes['guild_id'])) {
+            /** @var Guild $guild */
+            $guild = $this->guild ?? $this->factory->part(Guild::class, ['id' => $this->attributes['guild_id']], true);
+            if ($botperms = $guild->getBotPermissions()) {
+                if (! $botperms->ban_members) {
+                    return reject(new \DomainException("You do not have permission to ban members in the guild {$guild->id}."));
+                }
+            }
+
+            return $guild->bans->save($this, $reason);
+        }
+
+        return parent::save();
+    }
+
     /**
      * @inheritDoc
      */