feat: gifs integration with your favorite provider (giphy|klipy|any)

app/Actions/CreateCommit.php

@@ -4,6 +4,7 @@
 
 namespace App\Actions;
 
+use App\Dto\Gif;
 use App\Dto\NewPoll;
 use App\Dto\ThreadEngagement;
 use App\Enums\CommitStatus;
@@ -51,15 +52,15 @@ public function __construct(
      * @param  list<UploadedFile>  $images
      * @param  array<int, string|null>  $imageDescriptions
      */
-    public function handle(User $user, string $body, ?Commit $parent = null, ?Commit $quotedCommit = null, array $images = [], array $imageDescriptions = [], bool|string $linkPreview = true, ?NewPoll $poll = null): Commit
+    public function handle(User $user, string $body, ?Commit $parent = null, ?Commit $quotedCommit = null, array $images = [], array $imageDescriptions = [], bool|string $linkPreview = true, ?NewPoll $poll = null, ?Gif $gif = null): Commit
     {
         $url = match ($linkPreview) {
             true => $this->urls->first($body),
             false => null,
             default => $linkPreview,
         };
 
-        return DB::transaction(function () use ($user, $body, $parent, $quotedCommit, $images, $imageDescriptions, $url, $poll): Commit {
+        return DB::transaction(function () use ($user, $body, $parent, $quotedCommit, $images, $imageDescriptions, $url, $poll, $gif): Commit {
             $linkPreview = $this->linkPreviewFor($url);
             $createdAt = now();
             $hasGoodReputation = $user->hasGoodReputation();
@@ -77,6 +78,10 @@ public function handle(User $user, string $body, ?Commit $parent = null, ?Commit
                 'created_at' => $createdAt,
             ]);
 
+            if ($gif instanceof Gif) {
+                $commit->gif()->create($gif->toColumns());
+            }
+
             $this->createCommitTopics->handle($commit, $this->mentionedOrganizations->get($body, $mentions));
             $this->createCommitImages->handle($commit, $images, $imageDescriptions);
 

app/Actions/CreateUserFeed.php

@@ -71,6 +71,10 @@ private function entry(XMLWriter $xml, User $user, Commit $commit): void
             $this->link($xml, 'enclosure', $image->url(), 'image/webp');
         }
 
+        if ($commit->gif !== null) {
+            $this->link($xml, 'enclosure', $commit->gif->url, 'image/gif');
+        }
+
         $xml->writeElement('published', $commit->created_at->toAtomString());
         $xml->writeElement('updated', $commit->created_at->toAtomString());
 

app/Actions/UpdateCommitAiDecision.php

@@ -8,7 +8,11 @@
 use App\Models\Commit;
 use App\Models\CommitImage;
 use App\Services\OpenAI;
+use Illuminate\Support\Facades\Http;
+use Illuminate\Support\Facades\Image;
 use Illuminate\Support\Facades\Storage;
+use RuntimeException;
+use Throwable;
 
 final readonly class UpdateCommitAiDecision
 {
@@ -17,6 +21,10 @@
      */
     private const float AUTO_REJECT_THRESHOLD = 0.95;
 
+    private const int GIF_MAX_BYTES = 20 * 1024 * 1024;
+
+    private const int GIF_MAX_DIMENSION = 1600;
+
     public function __construct(
         private OpenAI $openAI,
         private UpdateCommitStatuses $updateCommitStatuses,
@@ -25,7 +33,7 @@ public function __construct(
     }
 
     /**
-     * Asks the AI whether the commit, images included, should be approved. The decision is mostly a hint for
+     * Asks the AI whether the commit, images and GIF included, should be approved. The decision is mostly a hint for
      * moderators: a clean commit is approved, and it is rejected, without a reason, when the AI is all but certain.
      * Failures, such as timeouts or rate limits, are thrown, so the caller can try again later.
      */
@@ -35,6 +43,10 @@ public function handle(Commit $commit): void
             fn (CommitImage $image): string => 'data:image/webp;base64,'.base64_encode((string) Storage::get($image->path)),
         )->all());
 
+        if ($commit->gif !== null) {
+            $images[] = $this->gifForModeration($commit->gif->url);
+        }
+
         $scores = $this->openAI->moderate($commit->body, $images);
 
         $categories = array_keys($scores);
@@ -56,4 +68,30 @@ public function handle(Commit $commit): void
             $this->updateCommitStatuses->handle([$commit->id], CommitStatus::Approved, onlyPending: true);
         }
     }
+
+    /**
+     * The moderation endpoint only accepts non-animated GIFs of at most 20 MB, while providers serve animated ones.
+     * Sending their first frame as WebP keeps the check on the image itself instead of relying on the browser filter.
+     */
+    private function gifForModeration(string $url): string
+    {
+        $response = Http::timeout(10)->withoutRedirecting()->get($url)->throw();
+        $body = $response->body();
+
+        if (mb_strlen($body) > self::GIF_MAX_BYTES) {
+            throw new RuntimeException('The GIF is too large to moderate.');
+        }
+
+        try {
+            $webp = Image::fromBytes($body)
+                ->usingGd()
+                ->scale(self::GIF_MAX_DIMENSION, self::GIF_MAX_DIMENSION)
+                ->optimize('webp', 60)
+                ->toBytes();
+        } catch (Throwable $throwable) {
+            throw new RuntimeException('The GIF could not be prepared for moderation.', $throwable->getCode(), previous: $throwable);
+        }
+
+        return 'data:image/webp;base64,'.base64_encode($webp);
+    }
 }

app/Dto/Gif.php

@@ -0,0 +1,41 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Dto;
+
+use App\Enums\GifProvider;
+
+/** A GIF picked from a provider; URLs kept exactly as its API returned them. */
+final readonly class Gif
+{
+    public function __construct(
+        public GifProvider $provider,
+        public string $id,
+        public string $url,
+        public string $pageUrl,
+        public ?string $title,
+        public ?string $username,
+        public int $width,
+        public int $height,
+    ) {
+        //
+    }
+
+    /**
+     * @return array<string, string|int|null>
+     */
+    public function toColumns(): array
+    {
+        return [
+            'provider' => $this->provider->value,
+            'provider_gif_id' => $this->id,
+            'url' => $this->url,
+            'page_url' => $this->pageUrl,
+            'title' => $this->title,
+            'username' => $this->username,
+            'width' => $this->width,
+            'height' => $this->height,
+        ];
+    }
+}

app/Enums/GifProvider.php

@@ -0,0 +1,41 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Enums;
+
+enum GifProvider: string
+{
+    case Giphy = 'giphy';
+    case Klipy = 'klipy';
+
+    public function label(): string
+    {
+        return match ($this) {
+            self::Giphy => 'GIPHY',
+            self::Klipy => 'KLIPY',
+        };
+    }
+
+    /**
+     * @return list<string>
+     */
+    public function mediaHostPatterns(): array
+    {
+        return match ($this) {
+            self::Giphy => ['/^media\d*\.giphy\.com$/'],
+            self::Klipy => ['/^static\d*\.klipy\.com$/'],
+        };
+    }
+
+    /**
+     * @return list<string>
+     */
+    public function pageHostPatterns(): array
+    {
+        return match ($this) {
+            self::Giphy => ['/^(www\.)?giphy\.com$/'],
+            self::Klipy => ['/^(www\.)?klipy\.com$/'],
+        };
+    }
+}

app/Http/Controllers/CommitController.php

@@ -66,7 +66,7 @@ public function store(CreateCommitRequest $request, #[CurrentUser] User $user, C
     {
         $before = $achievements->unlockedBadgeNames($user);
 
-        $commit = $action->handle($user, $request->string('body')->value(), quotedCommit: $request->quotedCommit(), images: $request->images(), imageDescriptions: $request->imageDescriptions(), linkPreview: $request->linkPreview(), poll: $request->poll());
+        $commit = $action->handle($user, $request->string('body')->value(), quotedCommit: $request->quotedCommit(), images: $request->images(), imageDescriptions: $request->imageDescriptions(), linkPreview: $request->linkPreview(), poll: $request->poll(), gif: $request->gif());
 
         $unlocked = $achievements->unlockedBadgeNames($user)->diff($before)->values();
 

app/Http/Controllers/CommitReplyController.php

@@ -26,7 +26,7 @@ public function index(ListCommitRepliesRequest $request, #[CurrentUser] ?User $u
 
     public function store(CreateCommitReplyRequest $request, #[CurrentUser] User $user, Commit $commit, CreateCommit $action, CommitThreadQuery $thread): JsonResponse
     {
-        $reply = $action->handle($user, $request->string('body')->value(), $commit, images: $request->images(), imageDescriptions: $request->imageDescriptions(), linkPreview: $request->linkPreview());
+        $reply = $action->handle($user, $request->string('body')->value(), $commit, images: $request->images(), imageDescriptions: $request->imageDescriptions(), linkPreview: $request->linkPreview(), gif: $request->gif());
         $parent = $thread->get($commit, $user);
 
         return response()->json([

app/Http/Requests/CreateCommitReplyRequest.php

@@ -5,6 +5,8 @@
 namespace App\Http\Requests;
 
 use App\Actions\CreateCommitImages;
+use App\Dto\Gif;
+use App\Enums\GifProvider;
 use App\Models\Commit;
 use App\Models\User;
 use App\Services\Urls;
@@ -14,6 +16,7 @@
 use Illuminate\Http\UploadedFile;
 use Illuminate\Validation\Rule;
 use Illuminate\Validation\Rules\Dimensions;
+use Illuminate\Validation\Rules\Enum;
 use Illuminate\Validation\Rules\File;
 use Illuminate\Validation\Rules\In;
 
@@ -38,11 +41,13 @@ public function prepareForValidation(): void
     /**
      * Images are checked by their contents, not their extension, and SVG is never accepted since it can carry scripts.
      *
-     * @return array<string, array<int, string|ValidationRule|File|Dimensions|In>>
+     * @return array<string, array<int, string|ValidationRule|File|Dimensions|Enum|In>>
      */
     public function rules(): array
     {
         $body = $this->input('body');
+        $rawProvider = $this->input('gif_provider');
+        $provider = is_string($rawProvider) ? (GifProvider::tryFrom($rawProvider) ?? GifProvider::Giphy) : GifProvider::Giphy;
 
         return [
             'body' => CreateCommitRequest::bodyRules($this->hasFile('images')),
@@ -58,6 +63,7 @@ public function rules(): array
             ],
             'image_descriptions' => ['nullable', 'list', 'max:'.CreateCommitImages::MAX_IMAGES],
             'image_descriptions.*' => ['nullable', 'string', 'max:'.CreateCommitImages::MAX_DESCRIPTION_LENGTH],
+            ...CreateCommitRequest::gifRules($provider),
         ];
     }
 
@@ -113,4 +119,22 @@ public function imageDescriptions(): array
 
         return $descriptions;
     }
+
+    public function gif(): ?Gif
+    {
+        if (! $this->filled('gif_id')) {
+            return null;
+        }
+
+        return new Gif(
+            GifProvider::from($this->string('gif_provider')->value()),
+            $this->string('gif_id')->value(),
+            $this->string('gif_url')->value(),
+            $this->string('gif_page_url')->value(),
+            $this->filled('gif_title') ? $this->string('gif_title')->value() : null,
+            $this->filled('gif_username') ? $this->string('gif_username')->value() : null,
+            $this->integer('gif_width'),
+            $this->integer('gif_height'),
+        );
+    }
 }

app/Http/Requests/CreateCommitRequest.php

@@ -5,11 +5,14 @@
 namespace App\Http\Requests;
 
 use App\Actions\CreateCommitImages;
+use App\Dto\Gif;
 use App\Dto\NewPoll;
+use App\Enums\GifProvider;
 use App\Enums\PollDuration;
 use App\Models\Commit;
 use App\Models\User;
 use App\Rules\CommitBodyLength;
+use App\Rules\GifUrl;
 use App\Rules\VisibleCommit;
 use App\Services\CommitBodies;
 use App\Services\Urls;
@@ -49,7 +52,7 @@ public static function normalizeBody(FormRequest $request): void
      *
      * @return array<string, array<int, string|ValidationRule|File|Dimensions|Enum>>
      */
-    public static function attachmentRules(): array
+    public static function attachmentRules(GifProvider $provider = GifProvider::Giphy): array
     {
         return [
             'poll' => ['nullable', 'array:options,duration', 'prohibits:parent_id,images'],
@@ -67,6 +70,26 @@ public static function attachmentRules(): array
             ],
             'image_descriptions' => ['nullable', 'list', 'max:'.CreateCommitImages::MAX_IMAGES],
             'image_descriptions.*' => ['nullable', 'string', 'max:'.CreateCommitImages::MAX_DESCRIPTION_LENGTH],
+            ...self::gifRules($provider),
+        ];
+    }
+
+    /**
+     * Shared by top-level commits and replies; replies have no poll field, but gif_id still prohibits one.
+     *
+     * @return array<string, array<int, string|ValidationRule|Enum>>
+     */
+    public static function gifRules(GifProvider $provider = GifProvider::Giphy): array
+    {
+        return [
+            'gif_provider' => ['nullable', 'string', Rule::enum(GifProvider::class), 'required_with:gif_id'],
+            'gif_id' => ['nullable', 'string', 'max:64', 'regex:/^[A-Za-z0-9-]+$/', 'prohibits:images,poll', 'required_with:gif_url'],
+            'gif_url' => ['nullable', 'string', 'max:2048', 'required_with:gif_id', new GifUrl($provider)],
+            'gif_page_url' => ['nullable', 'string', 'max:2048', 'required_with:gif_id', new GifUrl($provider, page: true)],
+            'gif_title' => ['nullable', 'string', 'max:300'],
+            'gif_username' => ['nullable', 'string', 'max:100'],
+            'gif_width' => ['nullable', 'integer', 'min:1', 'max:10000', 'required_with:gif_id'],
+            'gif_height' => ['nullable', 'integer', 'min:1', 'max:10000', 'required_with:gif_id'],
         ];
     }
 
@@ -83,7 +106,10 @@ public function rules(): array
         $user = $this->user();
         assert($user instanceof User);
         $body = $this->input('body');
-        $attachmentRules = self::attachmentRules();
+        $rawProvider = $this->input('gif_provider');
+        $provider = is_string($rawProvider) ? (GifProvider::tryFrom($rawProvider) ?? GifProvider::Giphy) : GifProvider::Giphy;
+
+        $attachmentRules = self::attachmentRules($provider);
         $attachmentRules['poll'][] = 'prohibits:quoted_commit_id';
 
         return [
@@ -169,6 +195,24 @@ public function quotedCommit(): ?Commit
             : null;
     }
 
+    public function gif(): ?Gif
+    {
+        if (! $this->filled('gif_id')) {
+            return null;
+        }
+
+        return new Gif(
+            GifProvider::from($this->string('gif_provider')->value()),
+            $this->string('gif_id')->value(),
+            $this->string('gif_url')->value(),
+            $this->string('gif_page_url')->value(),
+            $this->filled('gif_title') ? $this->string('gif_title')->value() : null,
+            $this->filled('gif_username') ? $this->string('gif_username')->value() : null,
+            $this->integer('gif_width'),
+            $this->integer('gif_height'),
+        );
+    }
+
     public function prepareForValidation(): void
     {
         self::normalizeBody($this);

app/Http/Resources/CommitResource.php

@@ -65,6 +65,7 @@ public function toArray(Request $request): array
             'images' => $this->whenLoaded('images', fn (): mixed => $this->status === CommitStatus::Approved || ! $this->imagesAreVisibleTo($request->user())
                 ? $this->images
                 : $this->images->map(fn (CommitImage $image): array => [...$image->toArray(), 'url' => $image->temporaryUrl()])),
+            'gif' => $this->gif?->toPayload(),
             'author' => UserResource::make($this->user),
         ];