From 63f393a07008b430f4b99a282d6ffc46a0eed94f Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Wed, 17 Jun 2026 11:07:57 -0300
Subject: [PATCH 01/34] feat(reddit): register reddit platform enum

---
 app/Enums/SocialAccount/Platform.php |  9 +++++++++
 tests/Unit/Enums/PlatformTest.php    | 14 ++++++++++++++
 2 files changed, 23 insertions(+)

diff --git a/app/Enums/SocialAccount/Platform.php b/app/Enums/SocialAccount/Platform.php
index 0d645c97..7cd2fe6b 100644
--- a/app/Enums/SocialAccount/Platform.php
+++ b/app/Enums/SocialAccount/Platform.php
@@ -22,6 +22,7 @@ enum Platform: string
     case Mastodon = 'mastodon';
     case Telegram = 'telegram';
     case Discord = 'discord';
+    case Reddit = 'reddit';
 
     public function label(): string
     {
@@ -40,6 +41,7 @@ public function label(): string
             self::Mastodon => 'Mastodon',
             self::Telegram => 'Telegram',
             self::Discord => 'Discord',
+            self::Reddit => 'Reddit',
         };
     }
 
@@ -59,6 +61,7 @@ public function color(): string
             self::Mastodon => '#6364FF',
             self::Telegram => '#26A5E4',
             self::Discord => '#5865F2',
+            self::Reddit => '#FF4500',
         };
     }
 
@@ -77,6 +80,7 @@ public function allowedMediaTypes(): array
             self::Mastodon => [MediaType::Image, MediaType::Video],
             self::Telegram => [MediaType::Image, MediaType::Video],
             self::Discord => [MediaType::Image, MediaType::Video],
+            self::Reddit => [MediaType::Image, MediaType::Video],
         };
     }
 
@@ -95,6 +99,7 @@ public function maxImages(): int
             self::Mastodon => 4,
             self::Telegram => 10,
             self::Discord => 10,
+            self::Reddit => 20,
         };
     }
 
@@ -135,6 +140,7 @@ public function maxContentLength(): int
             self::Mastodon => 500,
             self::Telegram => 4096,
             self::Discord => 2000,
+            self::Reddit => 40000,
         };
     }
 
@@ -180,6 +186,7 @@ public function recommendedAiContentLength(): int
             self::Telegram => 400,
             // Discord — conversational community posts read best when concise
             self::Discord => 280,
+            self::Reddit => 500,
         };
     }
 
@@ -203,6 +210,7 @@ public function requiredPublishScopes(): array
             self::Mastodon => ['write:statuses'],
             self::Telegram => [],
             self::Discord => [],
+            self::Reddit => ['submit'],
         };
     }
 
@@ -221,6 +229,7 @@ public function supportsTextOnly(): bool
             self::Mastodon => true,
             self::Telegram => true,
             self::Discord => true,
+            self::Reddit => true,
         };
     }
 
diff --git a/tests/Unit/Enums/PlatformTest.php b/tests/Unit/Enums/PlatformTest.php
index d28c3ed4..23adfe9f 100644
--- a/tests/Unit/Enums/PlatformTest.php
+++ b/tests/Unit/Enums/PlatformTest.php
@@ -108,3 +108,17 @@
 
     expect($enabled)->not->toContain(Platform::LinkedIn);
 });
+
+test('reddit platform exposes its metadata', function () {
+    expect(Platform::Reddit->value)->toBe('reddit')
+        ->and(Platform::Reddit->label())->toBe('Reddit')
+        ->and(Platform::Reddit->color())->toBe('#FF4500')
+        ->and(Platform::Reddit->allowedMediaTypes())->toBe([MediaType::Image, MediaType::Video])
+        ->and(Platform::Reddit->maxImages())->toBe(20)
+        ->and(Platform::Reddit->maxContentLength())->toBe(40000)
+        ->and(Platform::Reddit->recommendedAiContentLength())->toBe(500)
+        ->and(Platform::Reddit->requiredPublishScopes())->toBe(['submit'])
+        ->and(Platform::Reddit->supportsTextOnly())->toBeTrue()
+        ->and(Platform::Reddit->requiresContent())->toBeFalse()
+        ->and(Platform::Reddit->queue())->toBe('social-reddit');
+});

From a742840cfec1dd2095196f0265d44fbc2e054712 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Wed, 17 Jun 2026 11:11:17 -0300
Subject: [PATCH 02/34] feat(reddit): register reddit_post content type

---
 app/Enums/PostPlatform/ContentType.php | 8 ++++++++
 tests/Unit/Enums/ContentTypeTest.php   | 5 +++++
 2 files changed, 13 insertions(+)

diff --git a/app/Enums/PostPlatform/ContentType.php b/app/Enums/PostPlatform/ContentType.php
index 0c525df9..b544608b 100644
--- a/app/Enums/PostPlatform/ContentType.php
+++ b/app/Enums/PostPlatform/ContentType.php
@@ -56,6 +56,9 @@ enum ContentType: string
     // Discord
     case DiscordMessage = 'discord_message';
 
+    // Reddit
+    case RedditPost = 'reddit_post';
+
     /**
      * AI generation format for an Instagram carousel. Not a content type —
      * carousel posts are persisted as InstagramFeed.
@@ -85,6 +88,7 @@ public function label(): string
             self::MastodonPost => 'Post',
             self::TelegramPost => 'Post',
             self::DiscordMessage => 'Message',
+            self::RedditPost => 'Post',
         };
     }
 
@@ -109,6 +113,7 @@ public function platform(): SocialPlatform
             self::MastodonPost => SocialPlatform::Mastodon,
             self::TelegramPost => SocialPlatform::Telegram,
             self::DiscordMessage => SocialPlatform::Discord,
+            self::RedditPost => SocialPlatform::Reddit,
         };
     }
 
@@ -179,6 +184,7 @@ public function maxMediaCount(): int
             self::MastodonPost => 4,
             self::TelegramPost => 10,
             self::DiscordMessage => 10,
+            self::RedditPost => 20,
         };
     }
 
@@ -200,6 +206,7 @@ public function supportsVideo(): bool
             self::MastodonPost => true,
             self::TelegramPost => true,
             self::DiscordMessage => true,
+            self::RedditPost => true,
         };
     }
 
@@ -322,6 +329,7 @@ public static function defaultFor(SocialPlatform $platform): self
             SocialPlatform::Mastodon => self::MastodonPost,
             SocialPlatform::Telegram => self::TelegramPost,
             SocialPlatform::Discord => self::DiscordMessage,
+            SocialPlatform::Reddit => self::RedditPost,
         };
     }
 }
diff --git a/tests/Unit/Enums/ContentTypeTest.php b/tests/Unit/Enums/ContentTypeTest.php
index 7a771504..ee543985 100644
--- a/tests/Unit/Enums/ContentTypeTest.php
+++ b/tests/Unit/Enums/ContentTypeTest.php
@@ -142,3 +142,8 @@
     expect(ContentType::BlueskyPost->supportsVideo())->toBeTrue();
     expect(ContentType::MastodonPost->supportsVideo())->toBeTrue();
 });
+
+test('reddit post content type maps to reddit platform', function () {
+    expect(ContentType::RedditPost->value)->toBe('reddit_post')
+        ->and(ContentType::RedditPost->platform())->toBe(Platform::Reddit);
+});

From 587b06c28b0ee33e7e6675320a7f7794a60a2419 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Wed, 17 Jun 2026 11:12:33 -0300
Subject: [PATCH 03/34] feat(reddit): add reddit platform + oauth config

---
 .env.example        | 8 ++++++++
 config/services.php | 7 +++++++
 config/trypost.php  | 7 +++++++
 3 files changed, 22 insertions(+)

diff --git a/.env.example b/.env.example
index 235552aa..eaa4db94 100644
--- a/.env.example
+++ b/.env.example
@@ -169,6 +169,14 @@ DISCORD_CLIENT_SECRET=
 DISCORD_BOT_TOKEN=
 DISCORD_CLIENT_REDIRECT="${APP_URL}/accounts/discord/callback"
 
+# Reddit (create an app at https://www.reddit.com/prefs/apps — choose "web app")
+REDDIT_ENABLED=true
+REDDIT_CLIENT_ID=
+REDDIT_CLIENT_SECRET=
+REDDIT_CLIENT_REDIRECT="${APP_URL}/accounts/reddit/callback"
+REDDIT_USER_AGENT="web:it.trypost:1.0 (by /u/trypost)"
+REDDIT_SCOPES="identity,read,submit,flair,mysubreddits"
+
 # AI Services
 OPENAI_API_KEY=
 ANTHROPIC_API_KEY=
diff --git a/config/services.php b/config/services.php
index e72632d6..6489cf2a 100644
--- a/config/services.php
+++ b/config/services.php
@@ -118,6 +118,13 @@
         'redirect' => env('DISCORD_CLIENT_REDIRECT'),
     ],
 
+    // Reddit
+    'reddit' => [
+        'client_id' => env('REDDIT_CLIENT_ID'),
+        'client_secret' => env('REDDIT_CLIENT_SECRET'),
+        'redirect' => env('REDDIT_CLIENT_REDIRECT'),
+    ],
+
     'gtm' => [
         'id' => env('GTM_ID'),
     ],
diff --git a/config/trypost.php b/config/trypost.php
index 16bac3f5..b8c995f5 100644
--- a/config/trypost.php
+++ b/config/trypost.php
@@ -176,6 +176,13 @@
             'permissions' => env('DISCORD_PERMISSIONS', '248832'),
             'scopes' => array_values(array_filter(array_map('trim', explode(',', (string) env('DISCORD_SCOPES', 'bot,identify,guilds'))))),
         ],
+        'reddit' => [
+            'enabled' => env('REDDIT_ENABLED', true),
+            'api' => env('REDDIT_API', 'https://oauth.reddit.com'),
+            'oauth_api' => env('REDDIT_OAUTH_API', 'https://www.reddit.com/api/v1'),
+            'user_agent' => env('REDDIT_USER_AGENT', 'web:it.trypost:1.0 (by /u/trypost)'),
+            'scopes' => array_values(array_filter(array_map('trim', explode(',', (string) env('REDDIT_SCOPES', 'identity,read,submit,flair,mysubreddits'))))),
+        ],
     ],
 
 ];

From 47e5093107be4610e32a66fe76f5d957530160bc Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Wed, 17 Jun 2026 11:14:25 -0300
Subject: [PATCH 04/34] feat(reddit): add reddit socialite provider

---
 app/Providers/AppServiceProvider.php        |  7 ++
 app/Socialite/RedditProvider.php            | 95 +++++++++++++++++++++
 tests/Unit/Socialite/RedditProviderTest.php | 25 ++++++
 3 files changed, 127 insertions(+)
 create mode 100644 app/Socialite/RedditProvider.php
 create mode 100644 tests/Unit/Socialite/RedditProviderTest.php

diff --git a/app/Providers/AppServiceProvider.php b/app/Providers/AppServiceProvider.php
index 1ea3193d..d40e6311 100644
--- a/app/Providers/AppServiceProvider.php
+++ b/app/Providers/AppServiceProvider.php
@@ -34,6 +34,7 @@
 use App\Socialite\DiscordProvider;
 use App\Socialite\InstagramProvider;
 use App\Socialite\LinkedInPageExtendSocialite;
+use App\Socialite\RedditProvider;
 use Carbon\CarbonImmutable;
 use Illuminate\Auth\Notifications\ResetPassword;
 use Illuminate\Auth\Notifications\VerifyEmail;
@@ -193,6 +194,12 @@ protected function configureSocialite(): void
             return Socialite::buildProvider(DiscordProvider::class, $config);
         });
 
+        Socialite::extend('reddit', function ($app) {
+            $config = $app['config']['services.reddit'];
+
+            return Socialite::buildProvider(RedditProvider::class, $config);
+        });
+
         Event::listen(SocialiteWasCalled::class, FacebookExtendSocialite::class);
         Event::listen(SocialiteWasCalled::class, LinkedInExtendSocialite::class);
         Event::listen(SocialiteWasCalled::class, LinkedInPageExtendSocialite::class);
diff --git a/app/Socialite/RedditProvider.php b/app/Socialite/RedditProvider.php
new file mode 100644
index 00000000..1c55347b
--- /dev/null
+++ b/app/Socialite/RedditProvider.php
@@ -0,0 +1,95 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Socialite;
+
+use Laravel\Socialite\Two\AbstractProvider;
+use Laravel\Socialite\Two\ProviderInterface;
+use Laravel\Socialite\Two\User;
+
+/**
+ * Reddit OAuth2. The token endpoint uses HTTP Basic auth with the app
+ * credentials (not the access token), and Reddit requires a unique descriptive
+ * User-Agent on every request or it rate-limits/blocks. duration=permanent
+ * yields a refresh token that never expires.
+ */
+class RedditProvider extends AbstractProvider implements ProviderInterface
+{
+    protected $scopeSeparator = ' ';
+
+    protected function getAuthUrl($state): string
+    {
+        return $this->buildAuthUrlFromBase(config('trypost.platforms.reddit.oauth_api').'/authorize', $state);
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    protected function getCodeFields($state = null): array
+    {
+        return array_merge(parent::getCodeFields($state), [
+            'duration' => 'permanent',
+        ]);
+    }
+
+    protected function getTokenUrl(): string
+    {
+        return config('trypost.platforms.reddit.oauth_api').'/access_token';
+    }
+
+    /**
+     * Reddit's token endpoint authenticates the CLIENT via Basic auth, so the
+     * code grant is sent with the app credentials, not a bearer token.
+     *
+     * @return array<string, mixed>
+     */
+    public function getAccessTokenResponse($code): array
+    {
+        $response = $this->getHttpClient()->post($this->getTokenUrl(), [
+            'auth' => [config('services.reddit.client_id'), config('services.reddit.client_secret')],
+            'headers' => [
+                'Accept' => 'application/json',
+                'User-Agent' => config('trypost.platforms.reddit.user_agent'),
+            ],
+            'form_params' => [
+                'grant_type' => 'authorization_code',
+                'code' => $code,
+                'redirect_uri' => $this->redirectUrl,
+            ],
+        ]);
+
+        return json_decode((string) $response->getBody(), true);
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    protected function getUserByToken($token): array
+    {
+        $response = $this->getHttpClient()->get(config('trypost.platforms.reddit.api').'/api/v1/me', [
+            'headers' => [
+                'Authorization' => "Bearer {$token}",
+                'User-Agent' => config('trypost.platforms.reddit.user_agent'),
+            ],
+        ]);
+
+        return (array) json_decode((string) $response->getBody(), true);
+    }
+
+    /**
+     * @param  array<string, mixed>  $user
+     */
+    protected function mapUserToObject(array $user): User
+    {
+        $icon = (string) data_get($user, 'icon_img', '');
+        $icon = $icon !== '' ? strtok($icon, '?') : null;
+
+        return (new User)->setRaw($user)->map([
+            'id' => data_get($user, 'id'),
+            'nickname' => data_get($user, 'name'),
+            'name' => data_get($user, 'name'),
+            'avatar' => $icon,
+        ]);
+    }
+}
diff --git a/tests/Unit/Socialite/RedditProviderTest.php b/tests/Unit/Socialite/RedditProviderTest.php
new file mode 100644
index 00000000..1219b31f
--- /dev/null
+++ b/tests/Unit/Socialite/RedditProviderTest.php
@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Socialite\RedditProvider;
+use Illuminate\Http\Request;
+
+test('reddit auth url requests a permanent token with the configured scopes', function () {
+    config([
+        'trypost.platforms.reddit.oauth_api' => 'https://www.reddit.com/api/v1',
+        'services.reddit.client_id' => 'cid',
+        'services.reddit.redirect' => 'https://trypost.test/accounts/reddit/callback',
+    ]);
+
+    $request = Request::create('/connect/reddit', 'GET');
+    $request->setLaravelSession(app('session.store'));
+
+    $provider = new RedditProvider($request, 'cid', 'secret', 'https://trypost.test/accounts/reddit/callback');
+    $url = $provider->scopes(['identity', 'submit'])->redirect()->getTargetUrl();
+
+    expect($url)->toContain('https://www.reddit.com/api/v1/authorize')
+        ->toContain('duration=permanent')
+        ->toContain('client_id=cid')
+        ->toContain('scope=identity');
+});

From a2409d10558a4451dd6c8e6871241ba391d961fa Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Wed, 17 Jun 2026 11:19:16 -0300
Subject: [PATCH 05/34] feat(reddit): oauth connect + callback

---
 .../Controllers/Auth/RedditController.php     | 38 +++++++++
 database/factories/SocialAccountFactory.php   | 14 ++++
 routes/app.php                                |  4 +
 tests/Feature/Social/RedditConnectTest.php    | 79 +++++++++++++++++++
 4 files changed, 135 insertions(+)
 create mode 100644 app/Http/Controllers/Auth/RedditController.php
 create mode 100644 tests/Feature/Social/RedditConnectTest.php

diff --git a/app/Http/Controllers/Auth/RedditController.php b/app/Http/Controllers/Auth/RedditController.php
new file mode 100644
index 00000000..b23338e8
--- /dev/null
+++ b/app/Http/Controllers/Auth/RedditController.php
@@ -0,0 +1,38 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers\Auth;
+
+use App\Enums\SocialAccount\Platform as SocialPlatform;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Illuminate\View\View;
+use Symfony\Component\HttpFoundation\Response;
+
+class RedditController extends SocialController
+{
+    protected string $driver = 'reddit';
+
+    protected SocialPlatform $platform = SocialPlatform::Reddit;
+
+    public function connect(Request $request): Response|RedirectResponse
+    {
+        $this->ensurePlatformEnabled();
+
+        $workspace = $request->user()->currentWorkspace;
+
+        if (! $workspace) {
+            return redirect()->route('app.workspaces.create');
+        }
+
+        $this->authorize('manageAccounts', $workspace);
+
+        return $this->redirectToProvider($request, $this->driver, config('trypost.platforms.reddit.scopes'));
+    }
+
+    public function callback(Request $request): View
+    {
+        return $this->handleCallback($request, $this->platform, $this->driver);
+    }
+}
diff --git a/database/factories/SocialAccountFactory.php b/database/factories/SocialAccountFactory.php
index 927aba12..311412f5 100644
--- a/database/factories/SocialAccountFactory.php
+++ b/database/factories/SocialAccountFactory.php
@@ -154,6 +154,20 @@ public function telegram(): static
         ]);
     }
 
+    public function reddit(): static
+    {
+        return $this->state(fn (array $attributes) => [
+            'platform' => Platform::Reddit,
+            'scopes' => Platform::Reddit->requiredPublishScopes(),
+            'platform_user_id' => (string) $this->faker->numberBetween(100000, 999999),
+            'username' => $this->faker->userName(),
+            'display_name' => $this->faker->name(),
+            'access_token' => 'reddit-access-token',
+            'refresh_token' => 'reddit-refresh-token',
+            'token_expires_at' => now()->addHour(),
+        ]);
+    }
+
     public function discord(): static
     {
         return $this->state(fn (array $attributes) => [
diff --git a/routes/app.php b/routes/app.php
index 875748dc..54653f08 100644
--- a/routes/app.php
+++ b/routes/app.php
@@ -38,6 +38,7 @@
 use App\Http\Controllers\Auth\LinkedInPageController;
 use App\Http\Controllers\Auth\MastodonController;
 use App\Http\Controllers\Auth\PinterestController;
+use App\Http\Controllers\Auth\RedditController;
 use App\Http\Controllers\Auth\SocialController;
 use App\Http\Controllers\Auth\TelegramController;
 use App\Http\Controllers\Auth\ThreadsController;
@@ -125,6 +126,9 @@
 
     Route::get('connect/discord', [DiscordController::class, 'connect'])->name('app.social.discord.connect');
     Route::get('accounts/discord/callback', [DiscordController::class, 'callback'])->name('app.social.discord.callback');
+
+    Route::get('connect/reddit', [RedditController::class, 'connect'])->name('app.social.reddit.connect');
+    Route::get('accounts/reddit/callback', [RedditController::class, 'callback'])->name('app.social.reddit.callback');
 });
 
 // Routes that require active subscription and completed onboarding
diff --git a/tests/Feature/Social/RedditConnectTest.php b/tests/Feature/Social/RedditConnectTest.php
new file mode 100644
index 00000000..1b1ff828
--- /dev/null
+++ b/tests/Feature/Social/RedditConnectTest.php
@@ -0,0 +1,79 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Enums\SocialAccount\Platform;
+use App\Enums\SocialAccount\Status;
+use App\Enums\UserWorkspace\Role;
+use App\Models\User;
+use App\Models\Workspace;
+use Laravel\Socialite\Facades\Socialite;
+use Laravel\Socialite\Two\User as SocialiteUser;
+
+beforeEach(function () {
+    $this->user = User::factory()->create();
+    $this->workspace = Workspace::factory()->create(['user_id' => $this->user->id]);
+    $this->user->update(['current_workspace_id' => $this->workspace->id]);
+    $this->workspace->members()->attach($this->user->id, ['role' => Role::Member->value]);
+});
+
+test('reddit connect redirects to the oauth provider', function () {
+    $driverMock = Mockery::mock();
+    $driverMock->shouldReceive('scopes')->andReturnSelf();
+    $driverMock->shouldReceive('redirect')->andReturn(Mockery::mock([
+        'getTargetUrl' => 'https://www.reddit.com/api/v1/authorize?test=1',
+    ]));
+
+    Socialite::shouldReceive('driver')->with('reddit')->andReturn($driverMock);
+
+    $this->actingAs($this->user)
+        ->withHeader('X-Inertia', 'true')
+        ->get(route('app.social.reddit.connect'))
+        ->assertStatus(409);
+
+    expect(session('social_connect_workspace'))->toBe($this->workspace->id);
+});
+
+test('reddit oauth callback creates the account', function () {
+    session(['social_connect_workspace' => $this->workspace->id]);
+
+    $socialiteUser = Mockery::mock(SocialiteUser::class);
+    $socialiteUser->shouldReceive('getId')->andReturn('t2_abc123');
+    $socialiteUser->shouldReceive('getNickname')->andReturn('redditor_name');
+    $socialiteUser->shouldReceive('getName')->andReturn('Redditor Name');
+    $socialiteUser->shouldReceive('getAvatar')->andReturn(null);
+    $socialiteUser->token = 'reddit-access-token';
+    $socialiteUser->refreshToken = 'reddit-refresh-token';
+    $socialiteUser->expiresIn = 3600;
+    $socialiteUser->approvedScopes = ['submit'];
+
+    Socialite::shouldReceive('driver')->with('reddit')->andReturn(Mockery::mock(['user' => $socialiteUser]));
+
+    $response = $this->actingAs($this->user)->get(route('app.social.reddit.callback'));
+
+    $response->assertOk();
+    $response->assertViewHas('success', true);
+
+    $this->assertDatabaseHas('social_accounts', [
+        'workspace_id' => $this->workspace->id,
+        'platform' => Platform::Reddit->value,
+        'platform_user_id' => 't2_abc123',
+        'status' => Status::Connected->value,
+    ]);
+});
+
+test('reddit callback fails gracefully on socialite error', function () {
+    session(['social_connect_workspace' => $this->workspace->id]);
+
+    $mock = Mockery::mock();
+    $mock->shouldReceive('user')->andThrow(new RuntimeException('Reddit OAuth failed.'));
+
+    Socialite::shouldReceive('driver')->with('reddit')->andReturn($mock);
+
+    $response = $this->actingAs($this->user)->get(route('app.social.reddit.callback'));
+
+    $response->assertOk();
+    $response->assertViewHas('success', false);
+
+    expect($this->workspace->socialAccounts()->where('platform', Platform::Reddit)->count())->toBe(0);
+});

From 9d460702861f1bb46a898b21d72b851713e88d53 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Wed, 17 Jun 2026 11:22:57 -0300
Subject: [PATCH 06/34] feat(reddit): token verify + refresh

---
 app/Services/Social/ConnectionVerifier.php    | 40 +++++++++
 .../Social/ConnectionVerifierRedditTest.php   | 87 +++++++++++++++++++
 2 files changed, 127 insertions(+)
 create mode 100644 tests/Feature/Services/Social/ConnectionVerifierRedditTest.php

diff --git a/app/Services/Social/ConnectionVerifier.php b/app/Services/Social/ConnectionVerifier.php
index 92f62433..fd42fa36 100644
--- a/app/Services/Social/ConnectionVerifier.php
+++ b/app/Services/Social/ConnectionVerifier.php
@@ -70,6 +70,7 @@ private function callVerifyEndpoint(SocialAccount $account): bool
             Platform::Mastodon => $this->verifyMastodon($account),
             Platform::Telegram => $this->verifyTelegram($account),
             Platform::Discord => $this->verifyDiscord($account),
+            Platform::Reddit => $this->verifyReddit($account),
         };
     }
 
@@ -103,6 +104,7 @@ public function refreshToken(SocialAccount $account): void
                 Platform::Pinterest => $this->refreshPinterestToken($account),
                 Platform::Threads => $this->refreshThreadsToken($account),
                 Platform::Instagram => $this->refreshInstagramToken($account),
+                Platform::Reddit => $this->refreshRedditToken($account),
                 // Facebook / InstagramFacebook use Page tokens that don't expire.
                 // Mastodon tokens don't expire either.
                 default => null,
@@ -537,4 +539,42 @@ private function verifyMastodon(SocialAccount $account): bool
 
         return $response->successful();
     }
+
+    private function verifyReddit(SocialAccount $account): bool
+    {
+        $response = Http::withToken((string) $account->access_token)
+            ->withHeaders(['User-Agent' => (string) config('trypost.platforms.reddit.user_agent')])
+            ->get(config('trypost.platforms.reddit.api').'/api/v1/me');
+
+        if (in_array($response->status(), [401, 403], true)) {
+            throw new TokenExpiredException('Reddit access token is invalid or expired');
+        }
+
+        return $response->successful();
+    }
+
+    private function refreshRedditToken(SocialAccount $account): void
+    {
+        if (! $account->refresh_token) {
+            throw new TokenExpiredException('No refresh token available for Reddit account');
+        }
+
+        $response = TokenRefreshClient::for(Platform::Reddit)->send(fn () => Http::asForm()
+            ->withBasicAuth((string) config('services.reddit.client_id'), (string) config('services.reddit.client_secret'))
+            ->withHeaders(['User-Agent' => (string) config('trypost.platforms.reddit.user_agent')])
+            ->post(config('trypost.platforms.reddit.oauth_api').'/access_token', [
+                'grant_type' => 'refresh_token',
+                'refresh_token' => $account->refresh_token,
+            ]));
+
+        $data = $response->json();
+
+        $account->update([
+            'access_token' => data_get($data, 'access_token'),
+            'refresh_token' => data_get($data, 'refresh_token', $account->refresh_token),
+            'token_expires_at' => data_get($data, 'expires_in') ? now()->addSeconds((int) data_get($data, 'expires_in')) : null,
+        ]);
+
+        $account->refresh();
+    }
 }
diff --git a/tests/Feature/Services/Social/ConnectionVerifierRedditTest.php b/tests/Feature/Services/Social/ConnectionVerifierRedditTest.php
new file mode 100644
index 00000000..319f94f2
--- /dev/null
+++ b/tests/Feature/Services/Social/ConnectionVerifierRedditTest.php
@@ -0,0 +1,87 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Exceptions\TokenExpiredException;
+use App\Models\SocialAccount;
+use App\Services\Social\ConnectionVerifier;
+use Illuminate\Support\Facades\Http;
+
+test('verifies reddit account with valid token', function () {
+    Http::fake([
+        config('trypost.platforms.reddit.api').'/api/v1/me' => Http::response(['name' => 'testuser'], 200),
+    ]);
+
+    $account = SocialAccount::factory()->reddit()->create([
+        'token_expires_at' => now()->addDays(30),
+    ]);
+
+    $result = (new ConnectionVerifier)->verify($account);
+
+    expect($result)->toBeTrue();
+    Http::assertSent(fn ($request) => str_contains($request->url(), '/api/v1/me'));
+});
+
+test('throws TokenExpiredException when reddit verify returns 401', function () {
+    Http::fake([
+        config('trypost.platforms.reddit.api').'/api/v1/me' => Http::response([], 401),
+    ]);
+
+    $account = SocialAccount::factory()->reddit()->create([
+        'token_expires_at' => now()->addDays(30),
+    ]);
+
+    expect(fn () => (new ConnectionVerifier)->verify($account))
+        ->toThrow(TokenExpiredException::class, 'Reddit access token is invalid or expired');
+});
+
+test('refreshing a reddit token stores the new access token', function () {
+    Http::fake([
+        config('trypost.platforms.reddit.oauth_api').'/access_token' => Http::response([
+            'access_token' => 'new-access',
+            'expires_in' => 3600,
+        ], 200),
+    ]);
+
+    $account = SocialAccount::factory()->reddit()->create([
+        'access_token' => 'old-access',
+        'refresh_token' => 'reddit-refresh-token',
+    ]);
+
+    (new ConnectionVerifier)->refreshToken($account);
+
+    expect($account->fresh()->access_token)->toBe('new-access');
+});
+
+test('refreshes reddit token before verifying when expired', function () {
+    Http::fake([
+        config('trypost.platforms.reddit.oauth_api').'/access_token' => Http::response([
+            'access_token' => 'new-access',
+            'expires_in' => 3600,
+        ], 200),
+        config('trypost.platforms.reddit.api').'/api/v1/me' => Http::response(['name' => 'testuser'], 200),
+    ]);
+
+    $account = SocialAccount::factory()->reddit()->create([
+        'token_expires_at' => now()->subHour(),
+        'access_token' => 'old-access',
+        'refresh_token' => 'reddit-refresh-token',
+    ]);
+
+    $result = (new ConnectionVerifier)->verify($account);
+
+    expect($result)->toBeTrue();
+    expect($account->fresh()->access_token)->toBe('new-access');
+
+    Http::assertSent(fn ($request) => str_contains($request->url(), '/access_token'));
+});
+
+test('throws TokenExpiredException when reddit has no refresh token', function () {
+    $account = SocialAccount::factory()->reddit()->create([
+        'token_expires_at' => now()->subHour(),
+        'refresh_token' => null,
+    ]);
+
+    expect(fn () => (new ConnectionVerifier)->refreshToken($account))
+        ->toThrow(TokenExpiredException::class, 'No refresh token available for Reddit account');
+});

From ba39808d57264397477cfe8054ee59ccdcc8cf24 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Wed, 17 Jun 2026 11:25:16 -0300
Subject: [PATCH 07/34] feat(reddit): read-side api client (search,
 restrictions, flair, info)

---
 app/Services/Social/Reddit/RedditClient.php   | 126 ++++++++++++++++++
 .../Services/Social/RedditClientTest.php      |  71 ++++++++++
 2 files changed, 197 insertions(+)
 create mode 100644 app/Services/Social/Reddit/RedditClient.php
 create mode 100644 tests/Feature/Services/Social/RedditClientTest.php

diff --git a/app/Services/Social/Reddit/RedditClient.php b/app/Services/Social/Reddit/RedditClient.php
new file mode 100644
index 00000000..bf324c8b
--- /dev/null
+++ b/app/Services/Social/Reddit/RedditClient.php
@@ -0,0 +1,126 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Services\Social\Reddit;
+
+use App\Models\SocialAccount;
+use App\Services\Social\Concerns\HasSocialHttpClient;
+use Illuminate\Http\Client\PendingRequest;
+use Throwable;
+
+class RedditClient
+{
+    use HasSocialHttpClient;
+
+    /**
+     * @return list<array{name: string, title: string, subscribers: int, over_18: bool}>
+     */
+    public function searchSubreddits(SocialAccount $account, string $query): array
+    {
+        $response = $this->reddit($account)->get($this->url('/subreddits/search'), [
+            'q' => $query,
+            'show' => 'public',
+            'sort' => 'activity',
+            'show_users' => 'false',
+            'limit' => 10,
+        ]);
+
+        return collect(data_get($response->json(), 'data.children', []))
+            ->map(fn ($child) => [
+                'name' => (string) data_get($child, 'data.display_name'),
+                'title' => (string) data_get($child, 'data.title'),
+                'subscribers' => (int) data_get($child, 'data.subscribers', 0),
+                'over_18' => (bool) data_get($child, 'data.over18', false),
+            ])
+            ->filter(fn ($sub) => $sub['name'] !== '')
+            ->values()
+            ->all();
+    }
+
+    /**
+     * @return array{allowed_types: list<string>, flair_required: bool, flairs: list<array{id: string, text: string}>}
+     */
+    public function restrictions(SocialAccount $account, string $subreddit): array
+    {
+        $about = $this->reddit($account)->get($this->url("/r/{$subreddit}/about"))->json();
+        $submissionType = (string) data_get($about, 'data.submission_type', 'any');
+        $allowImages = (bool) data_get($about, 'data.allow_images', true);
+
+        $allowedTypes = match ($submissionType) {
+            'self' => ['self'],
+            'link' => ['link'],
+            default => ['self', 'link'],
+        };
+
+        if ($allowImages) {
+            $allowedTypes = array_merge($allowedTypes, ['image', 'video', 'gallery']);
+        }
+
+        $flairRequired = (bool) data_get(
+            $this->reddit($account)->get($this->url("/api/v1/{$subreddit}/post_requirements"))->json(),
+            'is_flair_required',
+            false
+        );
+
+        return [
+            'allowed_types' => $allowedTypes,
+            'flair_required' => $flairRequired,
+            'flairs' => $this->flairs($account, $subreddit),
+        ];
+    }
+
+    /**
+     * @return list<array{id: string, text: string}>
+     */
+    public function flairs(SocialAccount $account, string $subreddit): array
+    {
+        try {
+            return collect($this->reddit($account)->get($this->url("/r/{$subreddit}/api/link_flair_v2"))->json())
+                ->map(fn ($flair) => [
+                    'id' => (string) data_get($flair, 'id'),
+                    'text' => (string) data_get($flair, 'text'),
+                ])
+                ->filter(fn ($flair) => $flair['id'] !== '')
+                ->values()
+                ->all();
+        } catch (Throwable) {
+            return [];
+        }
+    }
+
+    /**
+     * @param  list<string>  $fullnames  Reddit fullnames, e.g. ['t3_abc123'].
+     * @return array<string, array{score: int, num_comments: int, url: string}>
+     */
+    public function info(SocialAccount $account, array $fullnames): array
+    {
+        if ($fullnames === []) {
+            return [];
+        }
+
+        $response = $this->reddit($account)->get($this->url('/api/info'), ['id' => implode(',', $fullnames)]);
+
+        return collect(data_get($response->json(), 'data.children', []))
+            ->mapWithKeys(fn ($child) => [
+                (string) data_get($child, 'data.name') => [
+                    'score' => (int) data_get($child, 'data.score', 0),
+                    'num_comments' => (int) data_get($child, 'data.num_comments', 0),
+                    'url' => (string) data_get($child, 'data.url', ''),
+                ],
+            ])
+            ->all();
+    }
+
+    private function url(string $path): string
+    {
+        return (string) config('trypost.platforms.reddit.api').$path;
+    }
+
+    private function reddit(SocialAccount $account): PendingRequest
+    {
+        return $this->socialHttp()
+            ->withToken((string) $account->access_token)
+            ->withHeaders(['User-Agent' => (string) config('trypost.platforms.reddit.user_agent')]);
+    }
+}
diff --git a/tests/Feature/Services/Social/RedditClientTest.php b/tests/Feature/Services/Social/RedditClientTest.php
new file mode 100644
index 00000000..d7b932fe
--- /dev/null
+++ b/tests/Feature/Services/Social/RedditClientTest.php
@@ -0,0 +1,71 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Models\SocialAccount;
+use App\Models\Workspace;
+use App\Services\Social\Reddit\RedditClient;
+use Illuminate\Support\Facades\Http;
+
+beforeEach(function () {
+    config([
+        'trypost.platforms.reddit.api' => 'https://oauth.reddit.com',
+        'trypost.platforms.reddit.user_agent' => 'web:it.trypost:1.0',
+    ]);
+    $this->account = SocialAccount::factory()->reddit()->create([
+        'workspace_id' => Workspace::factory()->create()->id,
+        'access_token' => 'tok',
+    ]);
+});
+
+test('searchSubreddits returns names from the reddit search endpoint', function () {
+    Http::fake([
+        'https://oauth.reddit.com/subreddits/search*' => Http::response([
+            'data' => ['children' => [
+                ['data' => ['display_name' => 'AskReddit', 'title' => 'Ask Reddit', 'subscribers' => 100, 'over18' => false, 'subreddit_type' => 'public']],
+                ['data' => ['display_name' => 'pics', 'title' => 'Pics', 'subscribers' => 50, 'over18' => false, 'subreddit_type' => 'public']],
+            ]],
+        ], 200),
+    ]);
+
+    $results = app(RedditClient::class)->searchSubreddits($this->account, 'ask');
+
+    expect($results)->toHaveCount(2)
+        ->and($results[0]['name'])->toBe('AskReddit');
+});
+
+test('restrictions reports submission type, image allowance and required flair', function () {
+    Http::fake([
+        'https://oauth.reddit.com/r/AskReddit/about*' => Http::response([
+            'data' => ['submission_type' => 'self', 'allow_images' => false],
+        ], 200),
+        'https://oauth.reddit.com/api/v1/AskReddit/post_requirements*' => Http::response([
+            'is_flair_required' => true,
+        ], 200),
+        'https://oauth.reddit.com/r/AskReddit/api/link_flair_v2*' => Http::response([
+            ['id' => 'abc', 'text' => 'Discussion'],
+        ], 200),
+    ]);
+
+    $restrictions = app(RedditClient::class)->restrictions($this->account, 'AskReddit');
+
+    expect($restrictions['allowed_types'])->toBe(['self'])
+        ->and($restrictions['flair_required'])->toBeTrue()
+        ->and($restrictions['flairs'][0]['id'])->toBe('abc');
+});
+
+test('info sums nothing for empty fullnames and maps children otherwise', function () {
+    Http::fake([
+        'https://oauth.reddit.com/api/info*' => Http::response([
+            'data' => ['children' => [
+                ['data' => ['name' => 't3_abc', 'score' => 12, 'num_comments' => 4, 'url' => 'https://www.reddit.com/r/x/comments/abc/y/']],
+            ]],
+        ], 200),
+    ]);
+
+    expect(app(RedditClient::class)->info($this->account, []))->toBe([]);
+
+    $info = app(RedditClient::class)->info($this->account, ['t3_abc']);
+    expect($info['t3_abc']['score'])->toBe(12)
+        ->and($info['t3_abc']['num_comments'])->toBe(4);
+});

From 6129d95000c8360fe6c0322958186702048e39a0 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Wed, 17 Jun 2026 11:27:50 -0300
Subject: [PATCH 08/34] feat(reddit): publish exception

---
 .../Social/RedditPublishException.php         | 83 ++++++++++++++++
 .../Social/RedditPublishExceptionTest.php     | 94 +++++++++++++++++++
 2 files changed, 177 insertions(+)
 create mode 100644 app/Exceptions/Social/RedditPublishException.php
 create mode 100644 tests/Unit/Exceptions/Social/RedditPublishExceptionTest.php

diff --git a/app/Exceptions/Social/RedditPublishException.php b/app/Exceptions/Social/RedditPublishException.php
new file mode 100644
index 00000000..72952c10
--- /dev/null
+++ b/app/Exceptions/Social/RedditPublishException.php
@@ -0,0 +1,83 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Exceptions\Social;
+
+use Illuminate\Http\Client\Response;
+use RuntimeException;
+use Throwable;
+
+class RedditPublishException extends SocialPublishException
+{
+    public function __construct(
+        string $userMessage,
+        ErrorCategory $category,
+        ?string $platformErrorCode = null,
+        ?string $rawResponse = null,
+        ?Throwable $previous = null,
+    ) {
+        $this->userMessage = $userMessage;
+        $this->category = $category;
+        $this->platformErrorCode = $platformErrorCode;
+        $this->rawResponse = $rawResponse;
+
+        RuntimeException::__construct($userMessage, 0, $previous);
+    }
+
+    public static function fromApiResponse(mixed $response): static
+    {
+        /** @var Response $response */
+        $status = $response->status();
+        $rawResponse = $response->body();
+        $json = $response->json() ?? [];
+
+        $errors = data_get($json, 'errors', []);
+        $apiMessage = is_array($errors) && count($errors) > 0
+            ? (string) data_get($errors, '0.1', '')
+            : '';
+
+        if ($status === 401 || $status === 403) {
+            return new static(
+                userMessage: 'Reddit rejected the request. Check that the account is connected and has permission to post.',
+                category: ErrorCategory::Permission,
+                platformErrorCode: (string) $status,
+                rawResponse: $rawResponse,
+            );
+        }
+
+        if ($status === 429) {
+            return new static(
+                userMessage: 'Reddit rate limit reached. Please try again shortly.',
+                category: ErrorCategory::RateLimit,
+                platformErrorCode: (string) $status,
+                rawResponse: $rawResponse,
+            );
+        }
+
+        if ($status >= 500) {
+            return new static(
+                userMessage: 'Reddit is temporarily unavailable. Please try again later.',
+                category: ErrorCategory::ServerError,
+                platformErrorCode: (string) $status,
+                rawResponse: $rawResponse,
+            );
+        }
+
+        $message = $apiMessage !== ''
+            ? $apiMessage
+            : "An unknown Reddit error occurred (HTTP {$status}).";
+
+        return new static(
+            userMessage: $message,
+            category: ErrorCategory::Unknown,
+            platformErrorCode: (string) $status,
+            rawResponse: $rawResponse,
+        );
+    }
+
+    public function platform(): string
+    {
+        return 'reddit';
+    }
+}
diff --git a/tests/Unit/Exceptions/Social/RedditPublishExceptionTest.php b/tests/Unit/Exceptions/Social/RedditPublishExceptionTest.php
new file mode 100644
index 00000000..52b22285
--- /dev/null
+++ b/tests/Unit/Exceptions/Social/RedditPublishExceptionTest.php
@@ -0,0 +1,94 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Exceptions\Social\ErrorCategory;
+use App\Exceptions\Social\RedditPublishException;
+use Illuminate\Support\Facades\Http;
+
+test('HTTP 401 maps to Permission category', function () {
+    $response = Http::response(['message' => 'Unauthorized'], 401);
+    $fakeResponse = Http::fake(['*' => $response])->post('https://oauth.reddit.com/api/submit');
+
+    $exception = RedditPublishException::fromApiResponse($fakeResponse);
+
+    expect($exception->category)->toBe(ErrorCategory::Permission)
+        ->and($exception->userMessage)->toBe('Reddit rejected the request. Check that the account is connected and has permission to post.')
+        ->and($exception->platformErrorCode)->toBe('401');
+});
+
+test('HTTP 403 maps to Permission category', function () {
+    $response = Http::response(['message' => 'Forbidden'], 403);
+    $fakeResponse = Http::fake(['*' => $response])->post('https://oauth.reddit.com/api/submit');
+
+    $exception = RedditPublishException::fromApiResponse($fakeResponse);
+
+    expect($exception->category)->toBe(ErrorCategory::Permission)
+        ->and($exception->platformErrorCode)->toBe('403');
+});
+
+test('HTTP 429 maps to RateLimit category', function () {
+    $response = Http::response([], 429);
+    $fakeResponse = Http::fake(['*' => $response])->post('https://oauth.reddit.com/api/submit');
+
+    $exception = RedditPublishException::fromApiResponse($fakeResponse);
+
+    expect($exception->category)->toBe(ErrorCategory::RateLimit)
+        ->and($exception->userMessage)->toBe('Reddit rate limit reached. Please try again shortly.')
+        ->and($exception->platformErrorCode)->toBe('429');
+});
+
+test('HTTP 500 maps to ServerError category', function () {
+    $response = Http::response([], 500);
+    $fakeResponse = Http::fake(['*' => $response])->post('https://oauth.reddit.com/api/submit');
+
+    $exception = RedditPublishException::fromApiResponse($fakeResponse);
+
+    expect($exception->category)->toBe(ErrorCategory::ServerError)
+        ->and($exception->userMessage)->toBe('Reddit is temporarily unavailable. Please try again later.')
+        ->and($exception->platformErrorCode)->toBe('500');
+});
+
+test('json errors array uses first error human message', function () {
+    $response = Http::response([
+        'jquery' => [],
+        'errors' => [['SUBREDDIT_NOEXIST', 'that subreddit does not exist', 'sr']],
+    ], 200);
+    $fakeResponse = Http::fake(['*' => $response])->post('https://oauth.reddit.com/api/submit');
+
+    $exception = RedditPublishException::fromApiResponse($fakeResponse);
+
+    expect($exception->category)->toBe(ErrorCategory::Unknown)
+        ->and($exception->userMessage)->toBe('that subreddit does not exist');
+});
+
+test('empty errors array falls back to generic message', function () {
+    $response = Http::response(['jquery' => [], 'errors' => []], 200);
+    $fakeResponse = Http::fake(['*' => $response])->post('https://oauth.reddit.com/api/submit');
+
+    $exception = RedditPublishException::fromApiResponse($fakeResponse);
+
+    expect($exception->category)->toBe(ErrorCategory::Unknown)
+        ->and($exception->userMessage)->toBe('An unknown Reddit error occurred (HTTP 200).');
+});
+
+test('previous throwable is forwarded', function () {
+    $previous = new RuntimeException('original cause');
+    $exception = new RedditPublishException(
+        userMessage: 'something failed',
+        category: ErrorCategory::Unknown,
+        previous: $previous,
+    );
+
+    expect($exception->getPrevious())->toBe($previous)
+        ->and($exception->getMessage())->toBe('something failed');
+});
+
+test('platform returns reddit', function () {
+    $response = Http::response(['errors' => []], 400);
+    $fakeResponse = Http::fake(['*' => $response])->post('https://oauth.reddit.com/api/submit');
+
+    $exception = RedditPublishException::fromApiResponse($fakeResponse);
+
+    expect($exception->platform())->toBe('reddit');
+});

From bb545f79bbfeb1c45725547f2cb3cab7b67962e8 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Wed, 17 Jun 2026 11:30:56 -0300
Subject: [PATCH 09/34] feat(reddit): publisher for self/link + multi-subreddit
 + partial failure

---
 .../Social/Reddit/RedditPublisher.php         | 192 ++++++++++++++++++
 .../Services/Social/RedditPublisherTest.php   | 111 ++++++++++
 2 files changed, 303 insertions(+)
 create mode 100644 app/Services/Social/Reddit/RedditPublisher.php
 create mode 100644 tests/Feature/Services/Social/RedditPublisherTest.php

diff --git a/app/Services/Social/Reddit/RedditPublisher.php b/app/Services/Social/Reddit/RedditPublisher.php
new file mode 100644
index 00000000..61ec0e75
--- /dev/null
+++ b/app/Services/Social/Reddit/RedditPublisher.php
@@ -0,0 +1,192 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Services\Social\Reddit;
+
+use App\Exceptions\Social\ErrorCategory;
+use App\Exceptions\Social\RedditPublishException;
+use App\Models\PostPlatform;
+use App\Models\SocialAccount;
+use App\Services\Social\Concerns\HasSocialHttpClient;
+use App\Services\Social\ContentSanitizer;
+use Illuminate\Http\Client\PendingRequest;
+use Illuminate\Http\Client\Response;
+use Throwable;
+
+/**
+ * Publishes to Reddit. A single Reddit PostPlatform may target many subreddits
+ * (meta.subreddits[]); each is its own /api/submit call (Reddit ~1 req/s, so we
+ * pace them). The final permalink is resolved by polling /api/info — no
+ * WebSocket. Partial failures keep the succeeded submissions and surface which
+ * sub failed.
+ */
+class RedditPublisher
+{
+    use HasSocialHttpClient;
+
+    private const SUBMIT_DELAY_MICROSECONDS = 1_100_000;
+
+    public function __construct(private readonly RedditClient $client) {}
+
+    /**
+     * @return array{id: string, url: string}
+     */
+    public function publish(PostPlatform $postPlatform): array
+    {
+        $account = $postPlatform->socialAccount;
+
+        $subreddits = collect((array) data_get($postPlatform->meta, 'subreddits', []))
+            ->filter(fn ($s) => filled(data_get($s, 'name')))
+            ->values();
+
+        if ($subreddits->isEmpty()) {
+            throw new RedditPublishException(
+                userMessage: 'No subreddit selected for this Reddit post.',
+                category: ErrorCategory::Unknown,
+            );
+        }
+
+        $text = $postPlatform->post->content
+            ? app(ContentSanitizer::class)->sanitize($postPlatform->post->content, $postPlatform->platform)
+            : '';
+
+        /** @var list<array{subreddit: string, id: string, url: string}> $results */
+        $results = [];
+
+        foreach ($subreddits as $index => $sub) {
+            if ($index > 0) {
+                usleep(self::SUBMIT_DELAY_MICROSECONDS);
+            }
+
+            try {
+                $results[] = $this->submitOne($account, $sub, $text);
+            } catch (Throwable $e) {
+                $this->persistResults($postPlatform, $results);
+
+                throw new RedditPublishException(
+                    userMessage: 'Published to '.count($results).' subreddit(s); failed on r/'.data_get($sub, 'name').': '.$e->getMessage(),
+                    category: ErrorCategory::Unknown,
+                    previous: $e,
+                );
+            }
+        }
+
+        $this->persistResults($postPlatform, $results);
+
+        return [
+            'id' => implode(',', array_column($results, 'id')),
+            'url' => implode(',', array_filter(array_column($results, 'url'))),
+        ];
+    }
+
+    /**
+     * @param  array<string, mixed>  $sub
+     * @return array{subreddit: string, id: string, url: string}
+     */
+    private function submitOne(SocialAccount $account, array $sub, string $text): array
+    {
+        $name = (string) data_get($sub, 'name');
+        $type = (string) data_get($sub, 'type', 'self');
+
+        $payload = array_filter([
+            'api_type' => 'json',
+            'sr' => $name,
+            'title' => (string) data_get($sub, 'title'),
+            'kind' => $this->kind($type),
+            'nsfw' => (bool) data_get($sub, 'nsfw', false) ? 'true' : null,
+            'spoiler' => (bool) data_get($sub, 'spoiler', false) ? 'true' : null,
+            'flair_id' => data_get($sub, 'flair_id') ?: null,
+            'flair_text' => data_get($sub, 'flair_text') ?: null,
+        ], fn ($v) => $v !== null);
+
+        if ($type === 'self') {
+            $payload['text'] = $text;
+        } elseif ($type === 'link') {
+            $payload['url'] = (string) data_get($sub, 'url');
+        } else {
+            $payload['url'] = $this->uploadMedia($account, $sub);
+        }
+
+        $response = $this->reddit($account)->asForm()->post($this->url('/api/submit'), $payload);
+
+        $this->assertOk($response);
+
+        $id = (string) data_get($response->json(), 'json.data.id');
+        $fullname = (string) data_get($response->json(), 'json.data.name');
+        $fullname = $fullname !== '' ? $fullname : ($id !== '' ? "t3_{$id}" : '');
+
+        return [
+            'subreddit' => $name,
+            'id' => $fullname,
+            'url' => $this->resolveUrl($account, $fullname),
+        ];
+    }
+
+    /**
+     * @param  array<string, mixed>  $sub
+     */
+    private function uploadMedia(SocialAccount $account, array $sub): string
+    {
+        throw new RedditPublishException(
+            userMessage: 'Reddit media upload is not available yet.',
+            category: ErrorCategory::MediaFormat,
+        );
+    }
+
+    private function resolveUrl(SocialAccount $account, string $fullname): string
+    {
+        if ($fullname === '') {
+            return '';
+        }
+
+        return (string) data_get($this->client->info($account, [$fullname]), "{$fullname}.url", '');
+    }
+
+    private function kind(string $type): string
+    {
+        return match ($type) {
+            'link' => 'link',
+            'image' => 'image',
+            'video' => 'video',
+            'gallery' => 'image',
+            default => 'self',
+        };
+    }
+
+    private function assertOk(Response $response): void
+    {
+        if ($response->failed()) {
+            throw RedditPublishException::fromApiResponse($response);
+        }
+
+        $errors = (array) data_get($response->json(), 'json.errors', []);
+
+        if ($errors !== []) {
+            throw new RedditPublishException(
+                userMessage: (string) (data_get($errors, '0.1') ?: 'Reddit rejected the submission.'),
+                category: ErrorCategory::Unknown,
+            );
+        }
+    }
+
+    /**
+     * @param  list<array{subreddit: string, id: string, url: string}>  $results
+     */
+    private function persistResults(PostPlatform $postPlatform, array $results): void
+    {
+        $postPlatform->update(['meta' => array_merge((array) $postPlatform->meta, ['results' => $results])]);
+    }
+
+    private function url(string $path): string
+    {
+        return (string) config('trypost.platforms.reddit.api').$path;
+    }
+
+    private function reddit(SocialAccount $account): PendingRequest
+    {
+        return $this->socialHttp()
+            ->withToken((string) $account->access_token)
+            ->withHeaders(['User-Agent' => (string) config('trypost.platforms.reddit.user_agent')]);
+    }
+}
diff --git a/tests/Feature/Services/Social/RedditPublisherTest.php b/tests/Feature/Services/Social/RedditPublisherTest.php
new file mode 100644
index 00000000..7e0df703
--- /dev/null
+++ b/tests/Feature/Services/Social/RedditPublisherTest.php
@@ -0,0 +1,111 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Enums\PostPlatform\ContentType;
+use App\Enums\SocialAccount\Platform;
+use App\Exceptions\Social\RedditPublishException;
+use App\Models\Post;
+use App\Models\PostPlatform;
+use App\Models\SocialAccount;
+use App\Models\User;
+use App\Models\Workspace;
+use App\Services\Social\Reddit\RedditPublisher;
+use Illuminate\Support\Facades\Http;
+
+beforeEach(function () {
+    config([
+        'trypost.platforms.reddit.api' => 'https://oauth.reddit.com',
+        'trypost.platforms.reddit.user_agent' => 'web:it.trypost:1.0',
+    ]);
+
+    $this->user = User::factory()->create();
+    $this->workspace = Workspace::factory()->create(['user_id' => $this->user->id]);
+    $this->account = SocialAccount::factory()->reddit()->create([
+        'workspace_id' => $this->workspace->id,
+        'access_token' => 'tok',
+    ]);
+    $this->post = Post::factory()->create([
+        'workspace_id' => $this->workspace->id,
+        'user_id' => $this->user->id,
+        'content' => 'Hello Reddit',
+    ]);
+});
+
+function redditPlatform(array $subreddits): PostPlatform
+{
+    return PostPlatform::factory()->create([
+        'post_id' => test()->post->id,
+        'social_account_id' => test()->account->id,
+        'platform' => Platform::Reddit,
+        'content_type' => ContentType::RedditPost,
+        'enabled' => true,
+        'meta' => ['subreddits' => $subreddits],
+    ]);
+}
+
+test('publishes a self post and resolves the url via info', function () {
+    Http::fake([
+        'https://oauth.reddit.com/api/submit*' => Http::response(['json' => ['errors' => [], 'data' => ['name' => 't3_abc', 'id' => 'abc']]], 200),
+        'https://oauth.reddit.com/api/info*' => Http::response(['data' => ['children' => [
+            ['data' => ['name' => 't3_abc', 'url' => 'https://www.reddit.com/r/test/comments/abc/x/']],
+        ]]], 200),
+    ]);
+
+    $platform = redditPlatform([['name' => 'test', 'title' => 'My title', 'type' => 'self']]);
+    $result = app(RedditPublisher::class)->publish($platform);
+
+    expect($result['id'])->toContain('abc')->and($result['url'])->toContain('reddit.com');
+    Http::assertSent(fn ($r) => str_contains($r->url(), '/api/submit') && $r['kind'] === 'self' && $r['sr'] === 'test' && $r['title'] === 'My title');
+});
+
+test('submits a link post with the url', function () {
+    Http::fake([
+        'https://oauth.reddit.com/api/submit*' => Http::response(['json' => ['errors' => [], 'data' => ['name' => 't3_l', 'id' => 'l']]], 200),
+        'https://oauth.reddit.com/api/info*' => Http::response(['data' => ['children' => []]], 200),
+    ]);
+
+    $platform = redditPlatform([['name' => 'test', 'title' => 'T', 'type' => 'link', 'url' => 'https://example.com']]);
+    app(RedditPublisher::class)->publish($platform);
+
+    Http::assertSent(fn ($r) => str_contains($r->url(), '/api/submit') && $r['kind'] === 'link' && $r['url'] === 'https://example.com');
+});
+
+test('submits to multiple subreddits and aggregates ids', function () {
+    Http::fake([
+        'https://oauth.reddit.com/api/submit*' => Http::sequence()
+            ->push(['json' => ['errors' => [], 'data' => ['name' => 't3_one', 'id' => 'one']]])
+            ->push(['json' => ['errors' => [], 'data' => ['name' => 't3_two', 'id' => 'two']]]),
+        'https://oauth.reddit.com/api/info*' => Http::response(['data' => ['children' => []]], 200),
+    ]);
+
+    $platform = redditPlatform([
+        ['name' => 'a', 'title' => 'T', 'type' => 'self'],
+        ['name' => 'b', 'title' => 'T', 'type' => 'self'],
+    ]);
+    $result = app(RedditPublisher::class)->publish($platform);
+
+    expect($result['id'])->toContain('one')->toContain('two');
+});
+
+test('records partial failure when a later subreddit fails', function () {
+    Http::fake([
+        'https://oauth.reddit.com/api/submit*' => Http::sequence()
+            ->push(['json' => ['errors' => [], 'data' => ['name' => 't3_one', 'id' => 'one']]])
+            ->push(['json' => ['errors' => [['SUBREDDIT_NOEXIST', 'that subreddit does not exist', 'sr']]]], 200),
+        'https://oauth.reddit.com/api/info*' => Http::response(['data' => ['children' => []]], 200),
+    ]);
+
+    $platform = redditPlatform([
+        ['name' => 'ok', 'title' => 'T', 'type' => 'self'],
+        ['name' => 'bad', 'title' => 'T', 'type' => 'self'],
+    ]);
+
+    expect(fn () => app(RedditPublisher::class)->publish($platform))->toThrow(RedditPublishException::class);
+    expect(data_get($platform->fresh()->meta, 'results.0.id'))->toContain('one');
+});
+
+test('throws when no subreddit is configured', function () {
+    $platform = redditPlatform([]);
+    expect(fn () => app(RedditPublisher::class)->publish($platform))->toThrow(RedditPublishException::class);
+});

From 982a1ba378ffaa5d8934250a92d3064b3b6e9e52 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Wed, 17 Jun 2026 11:35:57 -0300
Subject: [PATCH 10/34] fix(reddit): guard empty title, correct gallery kind,
 cover meta fields + media throw

---
 .../Social/Reddit/RedditPublisher.php         | 12 +++++--
 .../Services/Social/RedditPublisherTest.php   | 34 +++++++++++++++++++
 2 files changed, 44 insertions(+), 2 deletions(-)

diff --git a/app/Services/Social/Reddit/RedditPublisher.php b/app/Services/Social/Reddit/RedditPublisher.php
index 61ec0e75..2e539ba9 100644
--- a/app/Services/Social/Reddit/RedditPublisher.php
+++ b/app/Services/Social/Reddit/RedditPublisher.php
@@ -88,11 +88,19 @@ private function submitOne(SocialAccount $account, array $sub, string $text): ar
     {
         $name = (string) data_get($sub, 'name');
         $type = (string) data_get($sub, 'type', 'self');
+        $title = trim((string) data_get($sub, 'title'));
+
+        if ($title === '') {
+            throw new RedditPublishException(
+                userMessage: "A title is required to post to r/{$name}.",
+                category: ErrorCategory::Unknown,
+            );
+        }
 
         $payload = array_filter([
             'api_type' => 'json',
             'sr' => $name,
-            'title' => (string) data_get($sub, 'title'),
+            'title' => $title,
             'kind' => $this->kind($type),
             'nsfw' => (bool) data_get($sub, 'nsfw', false) ? 'true' : null,
             'spoiler' => (bool) data_get($sub, 'spoiler', false) ? 'true' : null,
@@ -149,7 +157,7 @@ private function kind(string $type): string
             'link' => 'link',
             'image' => 'image',
             'video' => 'video',
-            'gallery' => 'image',
+            'gallery' => 'gallery',
             default => 'self',
         };
     }
diff --git a/tests/Feature/Services/Social/RedditPublisherTest.php b/tests/Feature/Services/Social/RedditPublisherTest.php
index 7e0df703..eb4ac16b 100644
--- a/tests/Feature/Services/Social/RedditPublisherTest.php
+++ b/tests/Feature/Services/Social/RedditPublisherTest.php
@@ -109,3 +109,37 @@ function redditPlatform(array $subreddits): PostPlatform
     $platform = redditPlatform([]);
     expect(fn () => app(RedditPublisher::class)->publish($platform))->toThrow(RedditPublishException::class);
 });
+
+test('sends nsfw, spoiler and flair fields in the payload', function () {
+    Http::fake([
+        'https://oauth.reddit.com/api/submit*' => Http::response(['json' => ['errors' => [], 'data' => ['name' => 't3_abc', 'id' => 'abc']]], 200),
+        'https://oauth.reddit.com/api/info*' => Http::response(['data' => ['children' => []]], 200),
+    ]);
+
+    $platform = redditPlatform([[
+        'name' => 'test',
+        'title' => 'T',
+        'type' => 'self',
+        'nsfw' => true,
+        'spoiler' => true,
+        'flair_id' => 'flair-123',
+        'flair_text' => 'Discussion',
+    ]]);
+    app(RedditPublisher::class)->publish($platform);
+
+    Http::assertSent(fn ($r) => str_contains($r->url(), '/api/submit')
+        && $r['nsfw'] === 'true'
+        && $r['spoiler'] === 'true'
+        && $r['flair_id'] === 'flair-123'
+        && $r['flair_text'] === 'Discussion');
+});
+
+test('throws when a subreddit has no title', function () {
+    $platform = redditPlatform([['name' => 'test', 'type' => 'self']]);
+    expect(fn () => app(RedditPublisher::class)->publish($platform))->toThrow(RedditPublishException::class);
+});
+
+test('throws on media types since upload is not yet supported', function () {
+    $platform = redditPlatform([['name' => 'test', 'title' => 'T', 'type' => 'image']]);
+    expect(fn () => app(RedditPublisher::class)->publish($platform))->toThrow(RedditPublishException::class);
+});

From e1241084a2250ec91a22dca0f879f03ee335316a Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Wed, 17 Jun 2026 11:41:06 -0300
Subject: [PATCH 11/34] feat(reddit): single-image upload via asset lease
 (video/gallery deferred)

---
 app/Services/Social/Reddit/RedditClient.php   |  2 +-
 .../Social/Reddit/RedditPublisher.php         | 60 +++++++++++++++++--
 .../Services/Social/RedditClientTest.php      | 13 ++++
 .../Services/Social/RedditPublisherTest.php   | 40 ++++++++++++-
 4 files changed, 107 insertions(+), 8 deletions(-)

diff --git a/app/Services/Social/Reddit/RedditClient.php b/app/Services/Social/Reddit/RedditClient.php
index bf324c8b..507c6436 100644
--- a/app/Services/Social/Reddit/RedditClient.php
+++ b/app/Services/Social/Reddit/RedditClient.php
@@ -54,7 +54,7 @@ public function restrictions(SocialAccount $account, string $subreddit): array
         };
 
         if ($allowImages) {
-            $allowedTypes = array_merge($allowedTypes, ['image', 'video', 'gallery']);
+            $allowedTypes[] = 'image';
         }
 
         $flairRequired = (bool) data_get(
diff --git a/app/Services/Social/Reddit/RedditPublisher.php b/app/Services/Social/Reddit/RedditPublisher.php
index 2e539ba9..b6d3e25f 100644
--- a/app/Services/Social/Reddit/RedditPublisher.php
+++ b/app/Services/Social/Reddit/RedditPublisher.php
@@ -4,6 +4,7 @@
 
 namespace App\Services\Social\Reddit;
 
+use App\DataTransferObjects\MediaItem;
 use App\Exceptions\Social\ErrorCategory;
 use App\Exceptions\Social\RedditPublishException;
 use App\Models\PostPlatform;
@@ -12,6 +13,7 @@
 use App\Services\Social\ContentSanitizer;
 use Illuminate\Http\Client\PendingRequest;
 use Illuminate\Http\Client\Response;
+use Illuminate\Support\Facades\Http;
 use Throwable;
 
 /**
@@ -27,6 +29,8 @@ class RedditPublisher
 
     private const SUBMIT_DELAY_MICROSECONDS = 1_100_000;
 
+    private ?MediaItem $currentMedia = null;
+
     public function __construct(private readonly RedditClient $client) {}
 
     /**
@@ -51,6 +55,8 @@ public function publish(PostPlatform $postPlatform): array
             ? app(ContentSanitizer::class)->sanitize($postPlatform->post->content, $postPlatform->platform)
             : '';
 
+        $this->currentMedia = $postPlatform->post->mediaItems->first();
+
         /** @var list<array{subreddit: string, id: string, url: string}> $results */
         $results = [];
 
@@ -132,14 +138,62 @@ private function submitOne(SocialAccount $account, array $sub, string $text): ar
     }
 
     /**
+     * Uploads the post's first image through Reddit's asset lease and returns the
+     * hosted URL to submit as a link/image post.
+     *
      * @param  array<string, mixed>  $sub
      */
     private function uploadMedia(SocialAccount $account, array $sub): string
     {
-        throw new RedditPublishException(
-            userMessage: 'Reddit media upload is not available yet.',
+        $type = (string) data_get($sub, 'type');
+
+        if ($type !== 'image') {
+            throw new RedditPublishException(
+                userMessage: 'Reddit video and gallery posts are not supported yet.',
+                category: ErrorCategory::MediaFormat,
+            );
+        }
+
+        $item = $this->currentMedia ?? throw new RedditPublishException(
+            userMessage: 'No image attached for this Reddit image post.',
             category: ErrorCategory::MediaFormat,
         );
+
+        $mime = (string) ($item->mime_type ?: 'image/jpeg');
+        $filename = $item->original_filename ?: (basename((string) $item->path) ?: 'image');
+
+        $lease = $this->reddit($account)->asForm()->post($this->url('/api/media/asset'), [
+            'filepath' => $filename,
+            'mimetype' => $mime,
+        ]);
+        $this->assertOk($lease);
+
+        $action = 'https:'.preg_replace('#^https?:#', '', (string) data_get($lease->json(), 'args.action'));
+        $fields = collect((array) data_get($lease->json(), 'args.fields'))
+            ->mapWithKeys(fn ($f) => [(string) data_get($f, 'name') => (string) data_get($f, 'value')])
+            ->all();
+
+        $bytes = Http::timeout(120)->get($item->url)->body();
+
+        $upload = Http::asMultipart();
+        foreach ($fields as $name => $value) {
+            $upload = $upload->attach($name, $value);
+        }
+        $upload = $upload->attach('file', $bytes, $filename);
+        $s3 = $upload->post($action);
+
+        if ($s3->failed()) {
+            throw new RedditPublishException(
+                userMessage: 'Failed to upload the image to Reddit.',
+                category: ErrorCategory::MediaFormat,
+            );
+        }
+
+        if (preg_match('/<Location>(.*?)<\/Location>/', $s3->body(), $m)) {
+            return html_entity_decode($m[1]);
+        }
+
+        return rtrim($action, '/').'/'.($fields['key'] ?? $filename);
     }
 
     private function resolveUrl(SocialAccount $account, string $fullname): string
@@ -156,8 +210,6 @@ private function kind(string $type): string
         return match ($type) {
             'link' => 'link',
             'image' => 'image',
-            'video' => 'video',
-            'gallery' => 'gallery',
             default => 'self',
         };
     }
diff --git a/tests/Feature/Services/Social/RedditClientTest.php b/tests/Feature/Services/Social/RedditClientTest.php
index d7b932fe..e2d898e0 100644
--- a/tests/Feature/Services/Social/RedditClientTest.php
+++ b/tests/Feature/Services/Social/RedditClientTest.php
@@ -54,6 +54,19 @@
         ->and($restrictions['flairs'][0]['id'])->toBe('abc');
 });
 
+test('restrictions adds image (not video or gallery) when images are allowed', function () {
+    Http::fake([
+        'https://oauth.reddit.com/r/pics/about*' => Http::response(['data' => ['submission_type' => 'any', 'allow_images' => true]], 200),
+        'https://oauth.reddit.com/api/v1/pics/post_requirements*' => Http::response(['is_flair_required' => false], 200),
+        'https://oauth.reddit.com/r/pics/api/link_flair_v2*' => Http::response([], 200),
+    ]);
+
+    $r = app(RedditClient::class)->restrictions($this->account, 'pics');
+
+    expect($r['allowed_types'])->toContain('self')->toContain('link')->toContain('image')
+        ->not->toContain('video')->not->toContain('gallery');
+});
+
 test('info sums nothing for empty fullnames and maps children otherwise', function () {
     Http::fake([
         'https://oauth.reddit.com/api/info*' => Http::response([
diff --git a/tests/Feature/Services/Social/RedditPublisherTest.php b/tests/Feature/Services/Social/RedditPublisherTest.php
index eb4ac16b..e8b1965b 100644
--- a/tests/Feature/Services/Social/RedditPublisherTest.php
+++ b/tests/Feature/Services/Social/RedditPublisherTest.php
@@ -139,7 +139,41 @@ function redditPlatform(array $subreddits): PostPlatform
     expect(fn () => app(RedditPublisher::class)->publish($platform))->toThrow(RedditPublishException::class);
 });
 
-test('throws on media types since upload is not yet supported', function () {
-    $platform = redditPlatform([['name' => 'test', 'title' => 'T', 'type' => 'image']]);
-    expect(fn () => app(RedditPublisher::class)->publish($platform))->toThrow(RedditPublishException::class);
+test('throws for video and gallery since they are not yet supported', function () {
+    foreach (['video', 'gallery'] as $type) {
+        $platform = redditPlatform([['name' => 'test', 'title' => 'T', 'type' => $type]]);
+        expect(fn () => app(RedditPublisher::class)->publish($platform))->toThrow(RedditPublishException::class);
+    }
+});
+
+test('uploads an image then submits the asset url', function () {
+    test()->post->update([
+        'media' => [[
+            'id' => 'm1',
+            'path' => 'media/2026-01/photo.jpg',
+            'url' => 'https://cdn.test/photo.jpg',
+            'mime_type' => 'image/jpeg',
+            'original_filename' => 'photo.jpg',
+        ]],
+    ]);
+
+    Http::fake([
+        'https://oauth.reddit.com/api/media/asset*' => Http::response([
+            'args' => [
+                'action' => '//reddit-uploads.s3.amazonaws.com',
+                'fields' => [['name' => 'key', 'value' => 'abc/photo.jpg'], ['name' => 'policy', 'value' => 'p']],
+            ],
+            'asset' => ['asset_id' => 'a1'],
+        ], 200),
+        'https://reddit-uploads.s3.amazonaws.com' => Http::response('<?xml version="1.0"?><PostResponse><Location>https://reddit-uploads.s3.amazonaws.com/abc/photo.jpg</Location></PostResponse>', 201),
+        'https://cdn.test/photo.jpg' => Http::response('binarybytes', 200),
+        'https://oauth.reddit.com/api/submit*' => Http::response(['json' => ['errors' => [], 'data' => ['name' => 't3_img', 'id' => 'img']]], 200),
+        'https://oauth.reddit.com/api/info*' => Http::response(['data' => ['children' => []]], 200),
+    ]);
+
+    $platform = redditPlatform([['name' => 'pics', 'title' => 'My photo', 'type' => 'image']]);
+    $result = app(RedditPublisher::class)->publish($platform);
+
+    expect($result['id'])->toContain('img');
+    Http::assertSent(fn ($r) => str_contains($r->url(), '/api/submit') && isset($r['url']) && str_contains((string) $r['url'], 'photo.jpg'));
 });

From 2f373059270ceb75f43d2be3384bbd533feaf580 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Wed, 17 Jun 2026 11:43:07 -0300
Subject: [PATCH 12/34] feat(reddit): dispatch reddit posts to RedditPublisher

---
 app/Jobs/PublishToSocialPlatform.php | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/app/Jobs/PublishToSocialPlatform.php b/app/Jobs/PublishToSocialPlatform.php
index 5bf96054..0d2f1410 100644
--- a/app/Jobs/PublishToSocialPlatform.php
+++ b/app/Jobs/PublishToSocialPlatform.php
@@ -26,6 +26,7 @@
 use App\Services\Social\LinkedInPublisher;
 use App\Services\Social\MastodonPublisher;
 use App\Services\Social\PinterestPublisher;
+use App\Services\Social\Reddit\RedditPublisher;
 use App\Services\Social\Telegram\TelegramPublisher;
 use App\Services\Social\ThreadsPublisher;
 use App\Services\Social\TikTokPublisher;
@@ -223,7 +224,7 @@ private function broadcastStatus(): void
         PostPlatformStatusUpdated::dispatch($this->postPlatform->fresh());
     }
 
-    private function getPublisher(): LinkedInPublisher|LinkedInPagePublisher|XPublisher|TikTokPublisher|YouTubePublisher|FacebookPublisher|InstagramPublisher|ThreadsPublisher|PinterestPublisher|BlueskyPublisher|MastodonPublisher|TelegramPublisher|DiscordPublisher
+    private function getPublisher(): LinkedInPublisher|LinkedInPagePublisher|XPublisher|TikTokPublisher|YouTubePublisher|FacebookPublisher|InstagramPublisher|ThreadsPublisher|PinterestPublisher|BlueskyPublisher|MastodonPublisher|TelegramPublisher|DiscordPublisher|RedditPublisher
     {
         return match ($this->postPlatform->platform) {
             SocialPlatform::LinkedIn => app(LinkedInPublisher::class),
@@ -239,6 +240,7 @@ private function getPublisher(): LinkedInPublisher|LinkedInPagePublisher|XPublis
             SocialPlatform::Mastodon => app(MastodonPublisher::class),
             SocialPlatform::Telegram => app(TelegramPublisher::class),
             SocialPlatform::Discord => app(DiscordPublisher::class),
+            SocialPlatform::Reddit => app(RedditPublisher::class),
         };
     }
 

From 039983f0c93b5ae55d05678a95b8775bbf83d3cd Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Wed, 17 Jun 2026 11:45:50 -0300
Subject: [PATCH 13/34] feat(reddit): per-platform meta rules +
 required-on-publish

---
 app/Support/PostPlatformMetaRules.php         | 45 +++++++++++++++++++
 database/factories/PostPlatformFactory.php    |  8 ++++
 tests/Feature/Api/PostApiPlatformMetaTest.php | 39 ++++++++++++++++
 .../Feature/Mcp/PostPlatformMetaToolTest.php  | 44 ++++++++++++++++++
 4 files changed, 136 insertions(+)

diff --git a/app/Support/PostPlatformMetaRules.php b/app/Support/PostPlatformMetaRules.php
index d7a12682..f408d989 100644
--- a/app/Support/PostPlatformMetaRules.php
+++ b/app/Support/PostPlatformMetaRules.php
@@ -71,6 +71,20 @@ public static function rules(): array
             'platforms.*.meta.embeds.*.url' => ['sometimes', 'nullable', 'url'],
             'platforms.*.meta.embeds.*.image' => ['sometimes', 'nullable', 'url'],
             'platforms.*.meta.embeds.*.color' => ['sometimes', 'nullable', 'string', 'regex:/^#?[0-9A-Fa-f]{6}$/'],
+
+            // Reddit
+            'platforms.*.meta.subreddits' => ['sometimes', 'nullable', 'array'],
+            'platforms.*.meta.subreddits.*.name' => ['required', 'string'],
+            'platforms.*.meta.subreddits.*.title' => ['required', 'string', 'max:300'],
+            'platforms.*.meta.subreddits.*.type' => ['required', 'string', Rule::in(['self', 'link', 'image'])],
+            'platforms.*.meta.subreddits.*.url' => ['sometimes', 'nullable', 'url', 'required_if:platforms.*.meta.subreddits.*.type,link'],
+            'platforms.*.meta.subreddits.*.flair_id' => ['sometimes', 'nullable', 'string'],
+            'platforms.*.meta.subreddits.*.flair_text' => ['sometimes', 'nullable', 'string'],
+            'platforms.*.meta.subreddits.*.flair_required' => ['sometimes', 'boolean'],
+            'platforms.*.meta.subreddits.*.allowed_types' => ['sometimes', 'nullable', 'array'],
+            'platforms.*.meta.subreddits.*.allowed_types.*' => ['string'],
+            'platforms.*.meta.subreddits.*.nsfw' => ['sometimes', 'boolean'],
+            'platforms.*.meta.subreddits.*.spoiler' => ['sometimes', 'boolean'],
         ];
     }
 
@@ -130,11 +144,42 @@ public static function assertStoredPostPublishable(Post $post): void
      */
     private static function requiredMetaViolation(?Platform $platform, mixed $meta): ?array
     {
+        $reddit = $platform === Platform::Reddit ? self::redditMetaViolation($meta) : null;
+
         return match (true) {
+            $reddit !== null => $reddit,
             $platform === Platform::TikTok && blank(data_get($meta, 'privacy_level')) => ['privacy_level', trans('posts.form.tiktok.privacy_required')],
             $platform === Platform::Pinterest && blank(data_get($meta, 'board_id')) => ['board_id', trans('posts.form.pinterest.board_required')],
             $platform === Platform::Discord && blank(data_get($meta, 'channel_id')) => ['channel_id', trans('posts.form.discord.channel_required')],
             default => null,
         };
     }
+
+    /**
+     * @return array{0: string, 1: string}|null
+     */
+    private static function redditMetaViolation(mixed $meta): ?array
+    {
+        $subreddits = (array) data_get($meta, 'subreddits', []);
+
+        if ($subreddits === []) {
+            return ['subreddits', trans('posts.form.reddit.subreddit_required')];
+        }
+
+        foreach ($subreddits as $sub) {
+            if (blank(data_get($sub, 'title'))) {
+                return ['subreddits', trans('posts.form.reddit.title_required')];
+            }
+
+            if (data_get($sub, 'type') === 'link' && blank(data_get($sub, 'url'))) {
+                return ['subreddits', trans('posts.form.reddit.url_required')];
+            }
+
+            if (data_get($sub, 'flair_required') && blank(data_get($sub, 'flair_id'))) {
+                return ['subreddits', trans('posts.form.reddit.flair_required')];
+            }
+        }
+
+        return null;
+    }
 }
diff --git a/database/factories/PostPlatformFactory.php b/database/factories/PostPlatformFactory.php
index cb39e970..7cf8202c 100644
--- a/database/factories/PostPlatformFactory.php
+++ b/database/factories/PostPlatformFactory.php
@@ -163,6 +163,14 @@ public function discord(): static
         ]);
     }
 
+    public function reddit(): static
+    {
+        return $this->state(fn (array $attributes) => [
+            'platform' => Platform::Reddit,
+            'content_type' => ContentType::RedditPost,
+        ]);
+    }
+
     public function facebookReel(): static
     {
         return $this->state(fn (array $attributes) => [
diff --git a/tests/Feature/Api/PostApiPlatformMetaTest.php b/tests/Feature/Api/PostApiPlatformMetaTest.php
index 4865df41..5318b0a5 100644
--- a/tests/Feature/Api/PostApiPlatformMetaTest.php
+++ b/tests/Feature/Api/PostApiPlatformMetaTest.php
@@ -156,3 +156,42 @@
     expect($platform->fresh()->meta['channel_id'])->toBe('444555666');
     Queue::assertPushed(PublishPost::class);
 });
+
+it('persists Reddit subreddits meta on store', function () {
+    $account = SocialAccount::factory()->reddit()->create(['workspace_id' => $this->workspace->id]);
+
+    $this->withHeaders($this->headers)
+        ->postJson(route('api.posts.store'), [
+            'content' => 'Hello Reddit',
+            'platforms' => [[
+                'social_account_id' => $account->id,
+                'content_type' => ContentType::RedditPost->value,
+                'meta' => ['subreddits' => [['name' => 'AskReddit', 'title' => 'My title', 'type' => 'self', 'nsfw' => false]]],
+            ]],
+        ])
+        ->assertCreated();
+
+    $meta = PostPlatform::where('social_account_id', $account->id)->sole()->meta;
+
+    expect(data_get($meta, 'subreddits.0.name'))->toBe('AskReddit')
+        ->and(data_get($meta, 'subreddits.0.title'))->toBe('My title');
+});
+
+it('rejects publishing a Reddit post with no subreddit', function () {
+    $account = SocialAccount::factory()->reddit()->create(['workspace_id' => $this->workspace->id]);
+    $post = Post::factory()->create(['workspace_id' => $this->workspace->id, 'user_id' => $this->user->id]);
+    $platform = PostPlatform::factory()->reddit()->create([
+        'post_id' => $post->id,
+        'social_account_id' => $account->id,
+        'enabled' => true,
+        'meta' => ['subreddits' => []],
+    ]);
+
+    $this->withHeaders($this->headers)
+        ->putJson(route('api.posts.update', $post), [
+            'status' => PostStatus::Publishing->value,
+            'platforms' => [['id' => $platform->id]],
+        ])
+        ->assertUnprocessable()
+        ->assertJsonValidationErrors(['platforms.0.meta.subreddits']);
+});
diff --git a/tests/Feature/Mcp/PostPlatformMetaToolTest.php b/tests/Feature/Mcp/PostPlatformMetaToolTest.php
index 43f6ee26..69f13157 100644
--- a/tests/Feature/Mcp/PostPlatformMetaToolTest.php
+++ b/tests/Feature/Mcp/PostPlatformMetaToolTest.php
@@ -178,3 +178,47 @@
     $response->assertOk();
     Queue::assertPushed(PublishPost::class);
 });
+
+test('create post persists Reddit subreddits meta', function () {
+    $account = SocialAccount::factory()->reddit()->create(['workspace_id' => $this->workspace->id]);
+
+    $response = TryPostServer::actingAs($this->user)
+        ->tool(CreatePostTool::class, [
+            'content' => 'Hello Reddit',
+            'platforms' => [[
+                'social_account_id' => $account->id,
+                'content_type' => ContentType::RedditPost->value,
+                'meta' => [
+                    'subreddits' => [['name' => 'AskReddit', 'title' => 'My title', 'type' => 'self', 'nsfw' => false]],
+                ],
+            ]],
+        ]);
+
+    $response->assertOk();
+
+    $meta = PostPlatform::where('social_account_id', $account->id)->sole()->meta;
+
+    expect(data_get($meta, 'subreddits.0.name'))->toBe('AskReddit')
+        ->and(data_get($meta, 'subreddits.0.title'))->toBe('My title');
+});
+
+test('publish post rejects a Reddit platform without a subreddit', function () {
+    $account = SocialAccount::factory()->reddit()->create(['workspace_id' => $this->workspace->id]);
+
+    $post = Post::factory()->create([
+        'workspace_id' => $this->workspace->id,
+        'user_id' => $this->user->id,
+        'status' => PostStatus::Draft,
+    ]);
+    PostPlatform::factory()->reddit()->create([
+        'post_id' => $post->id,
+        'social_account_id' => $account->id,
+        'enabled' => true,
+        'meta' => ['subreddits' => []],
+    ]);
+
+    $response = TryPostServer::actingAs($this->user)
+        ->tool(PublishPostTool::class, ['post_id' => $post->id]);
+
+    $response->assertHasErrors([__('posts.form.reddit.subreddit_required')]);
+});

From c15bb6b70b1ba91e88f8c49fa9236ac4500335ea Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Wed, 17 Jun 2026 11:49:59 -0300
Subject: [PATCH 14/34] feat(reddit): subreddit search + restrictions endpoints

---
 app/Http/Controllers/App/RedditController.php | 48 +++++++++++++
 routes/app.php                                |  9 +++
 tests/Feature/Reddit/RedditLookupTest.php     | 67 +++++++++++++++++++
 3 files changed, 124 insertions(+)
 create mode 100644 app/Http/Controllers/App/RedditController.php
 create mode 100644 tests/Feature/Reddit/RedditLookupTest.php

diff --git a/app/Http/Controllers/App/RedditController.php b/app/Http/Controllers/App/RedditController.php
new file mode 100644
index 00000000..18b6a90a
--- /dev/null
+++ b/app/Http/Controllers/App/RedditController.php
@@ -0,0 +1,48 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers\App;
+
+use App\Enums\SocialAccount\Platform as SocialPlatform;
+use App\Http\Controllers\Controller;
+use App\Models\SocialAccount;
+use App\Services\Social\Reddit\RedditClient;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Symfony\Component\HttpFoundation\Response;
+
+class RedditController extends Controller
+{
+    public function __construct(private readonly RedditClient $client) {}
+
+    public function subreddits(Request $request, SocialAccount $account): JsonResponse
+    {
+        $this->authorizeRedditAccount($request, $account);
+
+        $query = trim((string) $request->query('q', ''));
+
+        return response()->json([
+            'data' => $query === '' ? [] : $this->client->searchSubreddits($account, $query),
+        ]);
+    }
+
+    public function restrictions(Request $request, SocialAccount $account, string $subreddit): JsonResponse
+    {
+        $this->authorizeRedditAccount($request, $account);
+
+        return response()->json(['data' => $this->client->restrictions($account, $subreddit)]);
+    }
+
+    private function authorizeRedditAccount(Request $request, SocialAccount $account): void
+    {
+        $workspace = $request->user()->currentWorkspace;
+
+        abort_unless(
+            $workspace && $account->workspace_id === $workspace->id && $account->platform === SocialPlatform::Reddit,
+            Response::HTTP_FORBIDDEN,
+        );
+
+        $this->authorize('view', $workspace);
+    }
+}
diff --git a/routes/app.php b/routes/app.php
index 54653f08..10d35314 100644
--- a/routes/app.php
+++ b/routes/app.php
@@ -18,6 +18,7 @@
 use App\Http\Controllers\App\PostController;
 use App\Http\Controllers\App\PostTemplateController;
 use App\Http\Controllers\App\PresenceController;
+use App\Http\Controllers\App\RedditController as AppRedditController;
 use App\Http\Controllers\App\Settings\AccountController;
 use App\Http\Controllers\App\Settings\AuthenticationController;
 use App\Http\Controllers\App\Settings\NotificationPreferenceController;
@@ -142,6 +143,14 @@
         ->middleware('throttle:60,1')
         ->name('app.discord.mentions');
 
+    // Reddit — live lookups for the composer (subreddit typeahead + restrictions/flair).
+    Route::get('reddit/accounts/{account}/subreddits', [AppRedditController::class, 'subreddits'])
+        ->middleware('throttle:60,1')
+        ->name('app.reddit.subreddits');
+    Route::get('reddit/accounts/{account}/subreddits/{subreddit}/restrictions', [AppRedditController::class, 'restrictions'])
+        ->middleware('throttle:60,1')
+        ->name('app.reddit.restrictions');
+
     // Workspaces
     Route::get('workspaces', [WorkspaceController::class, 'index'])->name('app.workspaces.index');
     Route::post('workspaces/{workspace}/switch', [WorkspaceController::class, 'switch'])->name('app.workspaces.switch');
diff --git a/tests/Feature/Reddit/RedditLookupTest.php b/tests/Feature/Reddit/RedditLookupTest.php
new file mode 100644
index 00000000..f4f6cbf4
--- /dev/null
+++ b/tests/Feature/Reddit/RedditLookupTest.php
@@ -0,0 +1,67 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Enums\UserWorkspace\Role;
+use App\Models\SocialAccount;
+use App\Models\User;
+use App\Models\Workspace;
+use Illuminate\Support\Facades\Http;
+
+beforeEach(function () {
+    config([
+        'trypost.platforms.reddit.api' => 'https://oauth.reddit.com',
+        'trypost.platforms.reddit.user_agent' => 'web:it.trypost:1.0',
+    ]);
+
+    $this->user = User::factory()->create();
+    $this->workspace = Workspace::factory()->create(['account_id' => $this->user->account_id, 'user_id' => $this->user->id]);
+    $this->workspace->members()->attach($this->user->id, ['role' => Role::Admin->value]);
+    $this->user->update(['current_workspace_id' => $this->workspace->id]);
+    $this->user->refresh();
+
+    $this->account = SocialAccount::factory()->reddit()->create(['workspace_id' => $this->workspace->id]);
+});
+
+test('searches subreddits for a connected account', function () {
+    Http::fake([
+        config('trypost.platforms.reddit.api').'/subreddits/search*' => Http::response([
+            'data' => ['children' => [['data' => ['display_name' => 'AskReddit', 'subreddit_type' => 'public', 'title' => 'Ask Reddit', 'subscribers' => 1, 'over18' => false]]]],
+        ], 200),
+    ]);
+
+    $this->actingAs($this->user)
+        ->getJson(route('app.reddit.subreddits', ['account' => $this->account->id, 'q' => 'ask']))
+        ->assertOk()
+        ->assertJsonPath('data.0.name', 'AskReddit');
+});
+
+test('returns empty array when query is blank', function () {
+    $this->actingAs($this->user)
+        ->getJson(route('app.reddit.subreddits', ['account' => $this->account->id, 'q' => '']))
+        ->assertOk()
+        ->assertJsonPath('data', []);
+});
+
+test('returns restrictions for a subreddit', function () {
+    Http::fake([
+        config('trypost.platforms.reddit.api').'/r/pics/about*' => Http::response(['data' => ['submission_type' => 'any', 'allow_images' => true]], 200),
+        config('trypost.platforms.reddit.api').'/api/v1/pics/post_requirements*' => Http::response(['is_flair_required' => false], 200),
+        config('trypost.platforms.reddit.api').'/r/pics/api/link_flair_v2*' => Http::response([], 200),
+    ]);
+
+    $this->actingAs($this->user)
+        ->getJson(route('app.reddit.restrictions', ['account' => $this->account->id, 'subreddit' => 'pics']))
+        ->assertOk()
+        ->assertJsonPath('data.allowed_types.0', 'self');
+});
+
+test('forbids looking up a reddit account in another workspace', function () {
+    $other = SocialAccount::factory()->reddit()->create([
+        'workspace_id' => Workspace::factory()->create()->id,
+    ]);
+
+    $this->actingAs($this->user)
+        ->getJson(route('app.reddit.subreddits', ['account' => $other->id, 'q' => 'x']))
+        ->assertForbidden();
+});

From 5ec17d184708309b21442ac6f6f2d777a52a3cce Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Wed, 17 Jun 2026 11:54:08 -0300
Subject: [PATCH 15/34] feat(reddit): post + account metrics (upvotes,
 comments, karma)

---
 .../Controllers/App/AnalyticsController.php   |  3 +
 app/Services/Post/PostMetricsFetcher.php      |  2 +
 .../Social/Reddit/RedditAnalytics.php         | 69 +++++++++++++++++
 app/Services/Social/Reddit/RedditClient.php   | 14 ++++
 lang/en/analytics.php                         |  2 +
 lang/es/analytics.php                         |  2 +
 lang/pt-BR/analytics.php                      |  2 +
 .../Services/Social/RedditAnalyticsTest.php   | 74 +++++++++++++++++++
 8 files changed, 168 insertions(+)
 create mode 100644 app/Services/Social/Reddit/RedditAnalytics.php
 create mode 100644 tests/Feature/Services/Social/RedditAnalyticsTest.php

diff --git a/app/Http/Controllers/App/AnalyticsController.php b/app/Http/Controllers/App/AnalyticsController.php
index aee64aad..818ce8ba 100644
--- a/app/Http/Controllers/App/AnalyticsController.php
+++ b/app/Http/Controllers/App/AnalyticsController.php
@@ -11,6 +11,7 @@
 use App\Services\Social\InstagramAnalytics;
 use App\Services\Social\LinkedInPageAnalytics;
 use App\Services\Social\PinterestAnalytics;
+use App\Services\Social\Reddit\RedditAnalytics;
 use App\Services\Social\Telegram\TelegramAnalytics;
 use App\Services\Social\ThreadsAnalytics;
 use App\Services\Social\TikTokAnalytics;
@@ -36,6 +37,7 @@ class AnalyticsController extends Controller
         Platform::Pinterest,
         Platform::YouTube,
         Platform::Telegram,
+        Platform::Reddit,
     ];
 
     public function index(Request $request): Response
@@ -80,6 +82,7 @@ public function show(Request $request, SocialAccount $account): JsonResponse
             Platform::Pinterest => app(PinterestAnalytics::class)->getMetrics($account, $since, $until),
             Platform::YouTube => app(YouTubeAnalytics::class)->getMetrics($account, $since, $until),
             Platform::Telegram => app(TelegramAnalytics::class)->getMetrics($account),
+            Platform::Reddit => app(RedditAnalytics::class)->getMetrics($account),
             default => [],
         };
 
diff --git a/app/Services/Post/PostMetricsFetcher.php b/app/Services/Post/PostMetricsFetcher.php
index b68e3305..935513f5 100644
--- a/app/Services/Post/PostMetricsFetcher.php
+++ b/app/Services/Post/PostMetricsFetcher.php
@@ -14,6 +14,7 @@
 use App\Services\Social\LinkedInPageAnalytics;
 use App\Services\Social\MastodonAnalytics;
 use App\Services\Social\PinterestAnalytics;
+use App\Services\Social\Reddit\RedditAnalytics;
 use App\Services\Social\Telegram\TelegramAnalytics;
 use App\Services\Social\ThreadsAnalytics;
 use App\Services\Social\XAnalytics;
@@ -74,6 +75,7 @@ public function forPlatform(PostPlatform $postPlatform): array
             Platform::LinkedInPage => app(LinkedInPageAnalytics::class)->fetchPostMetrics($postPlatform),
             Platform::YouTube => app(YouTubeAnalytics::class)->fetchPostMetrics($postPlatform),
             Platform::Pinterest => app(PinterestAnalytics::class)->fetchPostMetrics($postPlatform),
+            Platform::Reddit => app(RedditAnalytics::class)->fetchPostMetrics($postPlatform),
             default => ['unsupported' => true, 'reason' => 'platform_not_supported'],
         });
     }
diff --git a/app/Services/Social/Reddit/RedditAnalytics.php b/app/Services/Social/Reddit/RedditAnalytics.php
new file mode 100644
index 00000000..99bc8bce
--- /dev/null
+++ b/app/Services/Social/Reddit/RedditAnalytics.php
@@ -0,0 +1,69 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Services\Social\Reddit;
+
+use App\Models\PostPlatform;
+use App\Models\SocialAccount;
+use Throwable;
+
+/**
+ * Reddit engagement metrics. Account-level exposes the connected user's karma;
+ * per post, the summed upvote score and comment count across every subreddit the
+ * post was submitted to (PostPlatform.platform_post_id is a comma-joined list of
+ * Reddit fullnames).
+ */
+class RedditAnalytics
+{
+    public function __construct(private RedditClient $client) {}
+
+    /**
+     * @return array<int, array{label: string, value: int}>
+     */
+    public function getMetrics(SocialAccount $account): array
+    {
+        try {
+            $karma = $this->client->me($account);
+        } catch (Throwable) {
+            return [];
+        }
+
+        return [
+            ['label' => __('analytics.metrics.karma'), 'value' => $karma['total_karma']],
+        ];
+    }
+
+    /**
+     * @return array<int, array{label: string, value: int, kind?: string}>
+     */
+    public function fetchPostMetrics(PostPlatform $postPlatform): array
+    {
+        $account = $postPlatform->socialAccount;
+
+        $fullnames = collect(explode(',', (string) $postPlatform->platform_post_id))
+            ->map(fn ($id) => trim($id))
+            ->filter()
+            ->values()
+            ->all();
+
+        if (! $account || $fullnames === []) {
+            return [];
+        }
+
+        try {
+            $info = $this->client->info($account, $fullnames);
+        } catch (Throwable) {
+            return [];
+        }
+
+        if ($info === []) {
+            return [];
+        }
+
+        return [
+            ['label' => __('analytics.metrics.upvotes'), 'value' => (int) collect($info)->sum('score'), 'kind' => 'reaction'],
+            ['label' => __('analytics.metrics.comments'), 'value' => (int) collect($info)->sum('num_comments'), 'kind' => 'comments'],
+        ];
+    }
+}
diff --git a/app/Services/Social/Reddit/RedditClient.php b/app/Services/Social/Reddit/RedditClient.php
index 507c6436..f4f51fee 100644
--- a/app/Services/Social/Reddit/RedditClient.php
+++ b/app/Services/Social/Reddit/RedditClient.php
@@ -112,6 +112,20 @@ public function info(SocialAccount $account, array $fullnames): array
             ->all();
     }
 
+    /**
+     * @return array{link_karma: int, comment_karma: int, total_karma: int}
+     */
+    public function me(SocialAccount $account): array
+    {
+        $data = $this->reddit($account)->get($this->url('/api/v1/me'))->json();
+
+        return [
+            'link_karma' => (int) data_get($data, 'link_karma', 0),
+            'comment_karma' => (int) data_get($data, 'comment_karma', 0),
+            'total_karma' => (int) data_get($data, 'total_karma', 0),
+        ];
+    }
+
     private function url(string $path): string
     {
         return (string) config('trypost.platforms.reddit.api').$path;
diff --git a/lang/en/analytics.php b/lang/en/analytics.php
index 99c8190c..2737dda8 100644
--- a/lang/en/analytics.php
+++ b/lang/en/analytics.php
@@ -20,6 +20,7 @@
         'following' => 'Following',
         'impressions' => 'Impressions',
         'interactions' => 'Interactions',
+        'karma' => 'Karma',
         'likes' => 'Likes',
         'members' => 'Members',
         'minutes_watched' => 'Minutes Watched',
@@ -45,6 +46,7 @@
         'saves' => 'Saves',
         'shares' => 'Shares',
         'subscribers' => 'Subscribers',
+        'upvotes' => 'Upvotes',
         'subscribers_gained' => 'Subscribers Gained',
         'subscribers_lost' => 'Subscribers Lost',
         'total_likes' => 'Total Likes',
diff --git a/lang/es/analytics.php b/lang/es/analytics.php
index da4d2a40..f258cbbd 100644
--- a/lang/es/analytics.php
+++ b/lang/es/analytics.php
@@ -20,6 +20,7 @@
         'following' => 'Siguiendo',
         'impressions' => 'Impresiones',
         'interactions' => 'Interacciones',
+        'karma' => 'Karma',
         'likes' => 'Me gusta',
         'members' => 'Miembros',
         'minutes_watched' => 'Minutos Vistos',
@@ -45,6 +46,7 @@
         'saves' => 'Guardados',
         'shares' => 'Compartidos',
         'subscribers' => 'Suscriptores',
+        'upvotes' => 'Votos positivos',
         'subscribers_gained' => 'Suscriptores Ganados',
         'subscribers_lost' => 'Suscriptores Perdidos',
         'total_likes' => 'Total de Me gusta',
diff --git a/lang/pt-BR/analytics.php b/lang/pt-BR/analytics.php
index bad4c550..9c8fd496 100644
--- a/lang/pt-BR/analytics.php
+++ b/lang/pt-BR/analytics.php
@@ -20,6 +20,7 @@
         'following' => 'Seguindo',
         'impressions' => 'Impressões',
         'interactions' => 'Interações',
+        'karma' => 'Karma',
         'likes' => 'Curtidas',
         'members' => 'Membros',
         'minutes_watched' => 'Minutos Assistidos',
@@ -45,6 +46,7 @@
         'saves' => 'Salvos',
         'shares' => 'Compartilhamentos',
         'subscribers' => 'Inscritos',
+        'upvotes' => 'Votos positivos',
         'subscribers_gained' => 'Inscritos Ganhos',
         'subscribers_lost' => 'Inscritos Perdidos',
         'total_likes' => 'Curtidas Totais',
diff --git a/tests/Feature/Services/Social/RedditAnalyticsTest.php b/tests/Feature/Services/Social/RedditAnalyticsTest.php
new file mode 100644
index 00000000..3b1fb37b
--- /dev/null
+++ b/tests/Feature/Services/Social/RedditAnalyticsTest.php
@@ -0,0 +1,74 @@
+<?php
+
+declare(strict_types=1);
+
+use App\Models\PostPlatform;
+use App\Models\SocialAccount;
+use App\Models\Workspace;
+use App\Services\Social\Reddit\RedditAnalytics;
+use Illuminate\Http\Client\ConnectionException;
+use Illuminate\Support\Facades\Http;
+
+beforeEach(function () {
+    config([
+        'trypost.platforms.reddit.api' => 'https://oauth.reddit.com',
+        'trypost.platforms.reddit.user_agent' => 'web:it.trypost:1.0',
+    ]);
+    $this->account = SocialAccount::factory()->reddit()->create(['workspace_id' => Workspace::factory()->create()->id]);
+});
+
+test('post metrics sum score and comments across subreddits', function () {
+    Http::fake(['https://oauth.reddit.com/api/info*' => Http::response(['data' => ['children' => [
+        ['data' => ['name' => 't3_one', 'score' => 10, 'num_comments' => 3]],
+        ['data' => ['name' => 't3_two', 'score' => 5, 'num_comments' => 2]],
+    ]]], 200)]);
+
+    $platform = PostPlatform::factory()->reddit()->create([
+        'social_account_id' => $this->account->id,
+        'platform_post_id' => 't3_one,t3_two',
+    ]);
+
+    $metrics = app(RedditAnalytics::class)->fetchPostMetrics($platform);
+
+    expect($metrics)->not->toBeEmpty()
+        ->and((int) collect($metrics)->firstWhere('kind', 'reaction')['value'])->toBe(15)
+        ->and((int) collect($metrics)->firstWhere('kind', 'comments')['value'])->toBe(5);
+});
+
+test('account metrics expose total karma', function () {
+    Http::fake(['https://oauth.reddit.com/api/v1/me*' => Http::response(['total_karma' => 1234, 'link_karma' => 1000, 'comment_karma' => 234], 200)]);
+
+    $metrics = app(RedditAnalytics::class)->getMetrics($this->account);
+
+    expect((int) $metrics[0]['value'])->toBe(1234);
+});
+
+test('post metrics return empty when platform_post_id is blank', function () {
+    $platform = PostPlatform::factory()->reddit()->create([
+        'social_account_id' => $this->account->id,
+        'platform_post_id' => null,
+    ]);
+
+    expect(app(RedditAnalytics::class)->fetchPostMetrics($platform))->toBe([]);
+});
+
+test('post metrics return empty when info API returns no children', function () {
+    Http::fake(['https://oauth.reddit.com/api/info*' => Http::response(['data' => ['children' => []]], 200)]);
+
+    $platform = PostPlatform::factory()->reddit()->create([
+        'social_account_id' => $this->account->id,
+        'platform_post_id' => 't3_abc',
+    ]);
+
+    expect(app(RedditAnalytics::class)->fetchPostMetrics($platform))->toBe([]);
+});
+
+test('account metrics return empty when me API throws a connection exception', function () {
+    Http::fake(['https://oauth.reddit.com/api/v1/me*' => fn () => throw new ConnectionException('timeout')]);
+
+    $account = SocialAccount::factory()->reddit()->create(['workspace_id' => $this->account->workspace_id]);
+
+    $metrics = app(RedditAnalytics::class)->getMetrics($account);
+
+    expect($metrics)->toBe([]);
+});

From 8d6c5356da4055c4e3abad67c2b2a58a952db248 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Wed, 17 Jun 2026 11:57:40 -0300
Subject: [PATCH 16/34] feat(reddit): i18n keys (en, es, pt-BR)

---
 lang/en/posts.php    | 26 ++++++++++++++++++++++++++
 lang/es/posts.php    | 26 ++++++++++++++++++++++++++
 lang/pt-BR/posts.php | 26 ++++++++++++++++++++++++++
 3 files changed, 78 insertions(+)

diff --git a/lang/en/posts.php b/lang/en/posts.php
index 6fe57b73..0c916543 100644
--- a/lang/en/posts.php
+++ b/lang/en/posts.php
@@ -181,6 +181,27 @@
             'embed_image' => 'Image URL',
             'embed_color' => 'Color',
         ],
+        'reddit' => [
+            'settings' => 'Reddit Settings',
+            'add_subreddit' => 'Add subreddit',
+            'remove_subreddit' => 'Remove',
+            'subreddit' => 'Subreddit',
+            'search_subreddit' => 'Search subreddits…',
+            'title' => 'Title',
+            'post_type' => 'Post type',
+            'type_self' => 'Text',
+            'type_link' => 'Link',
+            'type_image' => 'Image',
+            'url' => 'Link URL',
+            'flair' => 'Flair',
+            'no_flair' => 'No flair',
+            'nsfw' => 'Mark as NSFW',
+            'spoiler' => 'Mark as spoiler',
+            'subreddit_required' => 'Add at least one subreddit to publish this post.',
+            'title_required' => 'Each subreddit needs a title.',
+            'url_required' => 'A link post needs a URL.',
+            'flair_required' => 'This subreddit requires a flair.',
+        ],
         'warnings' => [
             'no_variant' => 'Pick a post type to continue.',
             'requires_media' => 'This post type requires at least one image or video.',
@@ -512,6 +533,10 @@
             'label' => 'Message',
             'description' => 'Message to a Discord channel with optional media & embeds',
         ],
+        'reddit_post' => [
+            'label' => 'Post',
+            'description' => 'Text, link, or image post to a subreddit',
+        ],
     ],
 
     'platforms' => [
@@ -616,6 +641,7 @@
                 'mastodon_post' => 'Mastodon Post',
                 'telegram_post' => 'Telegram Post',
                 'discord_message' => 'Discord Message',
+                'reddit_post' => 'Reddit Post',
                 'facebook_post' => 'Facebook Post',
                 'pinterest_pin' => 'Pinterest Pin',
                 'instagram_story' => 'Instagram Story',
diff --git a/lang/es/posts.php b/lang/es/posts.php
index c1da9111..b36cf16d 100644
--- a/lang/es/posts.php
+++ b/lang/es/posts.php
@@ -181,6 +181,27 @@
             'embed_image' => 'URL de la imagen',
             'embed_color' => 'Color',
         ],
+        'reddit' => [
+            'settings' => 'Configuración de Reddit',
+            'add_subreddit' => 'Añadir subreddit',
+            'remove_subreddit' => 'Quitar',
+            'subreddit' => 'Subreddit',
+            'search_subreddit' => 'Buscar subreddits…',
+            'title' => 'Título',
+            'post_type' => 'Tipo de publicación',
+            'type_self' => 'Texto',
+            'type_link' => 'Enlace',
+            'type_image' => 'Imagen',
+            'url' => 'URL del enlace',
+            'flair' => 'Flair',
+            'no_flair' => 'Sin flair',
+            'nsfw' => 'Marcar como NSFW',
+            'spoiler' => 'Marcar como spoiler',
+            'subreddit_required' => 'Añade al menos un subreddit para publicar.',
+            'title_required' => 'Cada subreddit necesita un título.',
+            'url_required' => 'Una publicación de enlace necesita una URL.',
+            'flair_required' => 'Este subreddit requiere un flair.',
+        ],
         'warnings' => [
             'no_variant' => 'Elige un tipo de publicación para continuar.',
             'requires_media' => 'Este tipo requiere al menos una imagen o video.',
@@ -512,6 +533,10 @@
             'label' => 'Mensaje',
             'description' => 'Mensaje a un canal de Discord con multimedia y embeds opcionales',
         ],
+        'reddit_post' => [
+            'label' => 'Publicación',
+            'description' => 'Publicación de texto, enlace o imagen en un subreddit',
+        ],
     ],
 
     'platforms' => [
@@ -617,6 +642,7 @@
                 'mastodon_post' => 'Post en Mastodon',
                 'telegram_post' => 'Post en Telegram',
                 'discord_message' => 'Mensaje de Discord',
+                'reddit_post' => 'Publicación en Reddit',
                 'facebook_post' => 'Post en Facebook',
                 'pinterest_pin' => 'Pin de Pinterest',
                 'instagram_story' => 'Story de Instagram',
diff --git a/lang/pt-BR/posts.php b/lang/pt-BR/posts.php
index 831b745e..6905ed95 100644
--- a/lang/pt-BR/posts.php
+++ b/lang/pt-BR/posts.php
@@ -181,6 +181,27 @@
             'embed_image' => 'URL da imagem',
             'embed_color' => 'Cor',
         ],
+        'reddit' => [
+            'settings' => 'Configurações do Reddit',
+            'add_subreddit' => 'Adicionar subreddit',
+            'remove_subreddit' => 'Remover',
+            'subreddit' => 'Subreddit',
+            'search_subreddit' => 'Buscar subreddits…',
+            'title' => 'Título',
+            'post_type' => 'Tipo de post',
+            'type_self' => 'Texto',
+            'type_link' => 'Link',
+            'type_image' => 'Imagem',
+            'url' => 'URL do link',
+            'flair' => 'Flair',
+            'no_flair' => 'Sem flair',
+            'nsfw' => 'Marcar como NSFW',
+            'spoiler' => 'Marcar como spoiler',
+            'subreddit_required' => 'Adicione ao menos um subreddit para publicar.',
+            'title_required' => 'Cada subreddit precisa de um título.',
+            'url_required' => 'Um post de link precisa de uma URL.',
+            'flair_required' => 'Este subreddit exige um flair.',
+        ],
         'warnings' => [
             'no_variant' => 'Escolha um tipo de publicação para continuar.',
             'requires_media' => 'Este tipo exige pelo menos uma imagem ou vídeo.',
@@ -512,6 +533,10 @@
             'label' => 'Mensagem',
             'description' => 'Mensagem para um canal do Discord com mídia e embeds opcionais',
         ],
+        'reddit_post' => [
+            'label' => 'Post',
+            'description' => 'Post de texto, link ou imagem em um subreddit',
+        ],
     ],
 
     'platforms' => [
@@ -616,6 +641,7 @@
                 'mastodon_post' => 'Post no Mastodon',
                 'telegram_post' => 'Post no Telegram',
                 'discord_message' => 'Mensagem do Discord',
+                'reddit_post' => 'Post no Reddit',
                 'facebook_post' => 'Post no Facebook',
                 'pinterest_pin' => 'Pin no Pinterest',
                 'instagram_story' => 'Story do Instagram',

From 9002e35d8c53ef6de7bfc7dd8efb8fea74e2ae32 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Wed, 17 Jun 2026 12:24:32 -0300
Subject: [PATCH 17/34] feat(reddit): connect-account prompt i18n

---
 lang/en/accounts.php    | 1 +
 lang/es/accounts.php    | 1 +
 lang/pt-BR/accounts.php | 1 +
 3 files changed, 3 insertions(+)

diff --git a/lang/en/accounts.php b/lang/en/accounts.php
index 52871353..e4b2b455 100644
--- a/lang/en/accounts.php
+++ b/lang/en/accounts.php
@@ -53,6 +53,7 @@
         'mastodon' => 'Connect your Mastodon account',
         'telegram' => 'Connect a Telegram channel or group',
         'discord' => 'Connect a Discord server',
+        'reddit' => 'Connect your Reddit account',
     ],
 
     'disconnect_modal' => [
diff --git a/lang/es/accounts.php b/lang/es/accounts.php
index 3a8ed353..200a24f8 100644
--- a/lang/es/accounts.php
+++ b/lang/es/accounts.php
@@ -53,6 +53,7 @@
         'mastodon' => 'Conecta tu cuenta de Mastodon',
         'telegram' => 'Conecta un canal o grupo de Telegram',
         'discord' => 'Conecta un servidor de Discord',
+        'reddit' => 'Conecta tu cuenta de Reddit',
     ],
 
     'disconnect_modal' => [
diff --git a/lang/pt-BR/accounts.php b/lang/pt-BR/accounts.php
index a4382bb9..4c34162b 100644
--- a/lang/pt-BR/accounts.php
+++ b/lang/pt-BR/accounts.php
@@ -53,6 +53,7 @@
         'mastodon' => 'Conecte sua conta do Mastodon',
         'telegram' => 'Conecte um canal ou grupo do Telegram',
         'discord' => 'Conecte um servidor do Discord',
+        'reddit' => 'Conecte sua conta do Reddit',
     ],
 
     'disconnect_modal' => [

From 5ff696ddc37a1845a6f35dd5d87ebef0ae502f74 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Wed, 17 Jun 2026 12:25:56 -0300
Subject: [PATCH 18/34] feat(reddit): frontend platform registration + logo

---
 public/images/accounts/reddit.png                | Bin 0 -> 1546 bytes
 .../js/components/accounts/AddSocialDialog.vue   |   5 +++++
 resources/js/composables/usePlatformLogo.ts      |   3 +++
 resources/js/types/content-type.ts               |   1 +
 resources/js/types/platform.ts                   |   1 +
 5 files changed, 10 insertions(+)
 create mode 100644 public/images/accounts/reddit.png

diff --git a/public/images/accounts/reddit.png b/public/images/accounts/reddit.png
new file mode 100644
index 0000000000000000000000000000000000000000..14e73ac797b2a321e1a3e7aa94b6fed065eb2075
GIT binary patch
literal 1546
zcmV+l2KD)gP)<h;3K|Lk000e1NJLTq001%o001%w0ssI2kzF6=00009a7bBm000&x
z000&x0ZCFM@Bjb>yh%hsR9J=Wm}zVkRTRg6GxPeEz80Y@c7dR6LLpsPiv$8fSTq<?
zAsGE&R19ijB*xIjg+z%G3DE=^FeZiyq!@&tsDvOX(qIjgC8bhKp|lA?=?2}GxAe`7
zAKub=vpo9XgM8>eFO#|F-gEB%-gC~qXP%%I@)$z=zX_OQlvX?#r4<iGX~hGZxmW=K
z1OQYJ!p~rn@H-lL5CQOm4I~gXU7oN_XV`MYtSn)ZM@GxY$;beWJgA~TS|-y9xK%^@
zZTdX~!v0vin!M#S)lpsszK}`~lAcpcS~^Y<p%qIN24KTiEL?}G(BDl{9kmtI{YBP1
zUfmWNHhmF$Hi8^w(>Q;u%ST5GgYR_y?T4S*sXRnQ8M9ZBy?`k>jL#s!5oPw3WW4<*
z3)8@2x3mg^L1JZYaym)ls5(yVWv*UE1gFUOG<IEK%tW)rSz-j4sEcvJJETT8fv573
zY}8faf<$nFs_^e!%J&WHUicN?V63$Pv0_UXKvoeJ5h{>1hyG65eWZki0whD}hqN}3
zvxMe)eknnf_3JdwZysC5(24As)hb1a;-kniTi4?@WP>M6-KFu6YH2X069vsv*HokZ
zsDflCdp>`clc4dk8lE-i(?qig%@%1v%XmKNTp1arfDA*R+DS?0ayi0q`s>d>t-+YE
zh%F;aT_y%#2n29RB#*_NLe64<iIc!fe<uT8hQLN>^R%lSK~l#&w;~Kwuz?6F_y9<K
zl9?-+^E^}YNJ%I032X_dDyVq+>Fc1Sf!Z_Flv7`gPsJHlmq7suq?r2<E93(pi=?IE
zaM9X?#|MxzmzTDX`z%Q*F&6}YBGXt+c`2t#@diL3BNclR_wF$0#bK#uO-liXo6QH9
z{Tz~wJJ&f-%z|~ScvF9Bj|BA>*<Z}6w|J%y$xd4%d*7$(G_H7Q*_?cKlKiC_p@Q%T
zg^*GGgSp(SHVtp<Ow3(E?&4_SqZMaH^^H4`&9l-v6DMRKT7;z{Q(M7}Dsq=HW1%_S
zu4XC^<8-rdy=4@ROT}$x$R7`_t~OK^!7P0bZsCU=C}4+ock{w~2HjRR<<ZiK1lhaU
ze%72>Ul)UZ>?S?de)*@8#%dF}-^2GiaDW>`*tN-I%-$mIcaj7ysJ+IyW9CzoeFElA
zw5B!C$JW)<U(m}3yHUb=5)7E>cD9H1KmZAP?iq~qQt~<%&R~!0@&Rnn(aymy^zyN3
z6wId=ywD4U>rHfDF2Vy|@POOSqILQKjWwJ;LJ|;f$P>OgjQIQ%N49bE68TGcvDjq5
ztW|vZ8z=VQNThHx>C^NBL~w%tA*xeAg7#Y`z3#DW_}W}Cf`T;^tg-CvZo}^ly~kHU
z1h40=R+{S{z~CWp<rGS+ehXTWTB@gmKM$LaxqIUQb9Xl5HOq+J`<yIAGL*OvrbT$e
zL@4{zgu%VrypzNJV!B&Rbmah-j`MalCw80kZYzx1Dl=v=D~KQhFkvz~FETDIYRvHx
z_HITL$X~{k=}gMRW~Zl(raG=y(Q=1*D=0d|m<huwN`QUE{9J-v4Si%=z?v4(%%;rX
zqr*(iiyGF|!nvbVpQO2gp8F^P5|f$qG?}wm_8M7p5jEaWRleKAv2SojFW#&Yv@Qd+
z%vA7$JCQfGvwQ=tWW!(;-vEk&!-Zsas9ZZs*~e6$Co$SA@m8nCPaPS2kTs39MJ!kw
z<sB=?LtH=4@89yrkEjfv>DGisMvG{2Dhz=P6H}PEf>|rcoJC3ot|TNof`A;r@1?JU
z=6Y%?s41u6Dgi={v--*ysS{2AoYCg948eNDCE`xTm5jrMAQA8}*o&u+0Y8E8Js}!C
zD~t<{#t8m{&^9A3u!U6>g}xqodWQWH{MiYW>T0wd4EzEj3Hr0uf|l+$6Rew&Qo;&?
w;i>B~a5B#SxL}l4JQ$@F4@POlgU6KCf8f&sia_GxVE_OC07*qoM6N<$g6Ck`pa1{>

literal 0
HcmV?d00001

diff --git a/resources/js/components/accounts/AddSocialDialog.vue b/resources/js/components/accounts/AddSocialDialog.vue
index fdee97f1..6654fe66 100644
--- a/resources/js/components/accounts/AddSocialDialog.vue
+++ b/resources/js/components/accounts/AddSocialDialog.vue
@@ -109,6 +109,11 @@ const platformTheme: Record<
         rotate: 'rotate-1',
         image: '/images/accounts/discord.png',
     },
+    reddit: {
+        bg: 'bg-orange-200',
+        rotate: '-rotate-1',
+        image: '/images/accounts/reddit.png',
+    },
 };
 
 const themeFor = (value: string) =>
diff --git a/resources/js/composables/usePlatformLogo.ts b/resources/js/composables/usePlatformLogo.ts
index e00fd0f1..018c805c 100644
--- a/resources/js/composables/usePlatformLogo.ts
+++ b/resources/js/composables/usePlatformLogo.ts
@@ -13,6 +13,7 @@ const PLATFORM_LOGOS: Record<string, string> = {
     mastodon: '/images/accounts/mastodon.png',
     telegram: '/images/accounts/telegram.png',
     discord: '/images/accounts/discord.png',
+    reddit: '/images/accounts/reddit.png',
 };
 
 const PLATFORM_LABELS: Record<string, string> = {
@@ -30,6 +31,7 @@ const PLATFORM_LABELS: Record<string, string> = {
     mastodon: 'Mastodon',
     telegram: 'Telegram',
     discord: 'Discord',
+    reddit: 'Reddit',
 };
 
 const PLATFORM_CONTENT_TYPES: Record<string, string[]> = {
@@ -51,6 +53,7 @@ const PLATFORM_CONTENT_TYPES: Record<string, string[]> = {
     mastodon: ['mastodon_post'],
     telegram: ['telegram_post'],
     discord: ['discord_message'],
+    reddit: ['reddit_post'],
 };
 
 export interface ContentTypeOption {
diff --git a/resources/js/types/content-type.ts b/resources/js/types/content-type.ts
index 417e6cfc..eaad5c13 100644
--- a/resources/js/types/content-type.ts
+++ b/resources/js/types/content-type.ts
@@ -21,6 +21,7 @@ export const ContentType = {
     MastodonPost: 'mastodon_post',
     TelegramPost: 'telegram_post',
     DiscordMessage: 'discord_message',
+    RedditPost: 'reddit_post',
 } as const;
 
 export type ContentTypeValue = (typeof ContentType)[keyof typeof ContentType];
diff --git a/resources/js/types/platform.ts b/resources/js/types/platform.ts
index 82c86318..30cdbb2f 100644
--- a/resources/js/types/platform.ts
+++ b/resources/js/types/platform.ts
@@ -13,6 +13,7 @@ export const Platform = {
     Mastodon: 'mastodon',
     Telegram: 'telegram',
     Discord: 'discord',
+    Reddit: 'reddit',
 } as const;
 
 export type PlatformValue = (typeof Platform)[keyof typeof Platform];

From 798ece47b7a235ba7a9641de651b632ee55e08d8 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Wed, 17 Jun 2026 12:29:47 -0300
Subject: [PATCH 19/34] feat(reddit): composer subreddit settings panel

---
 .../js/components/ChannelConfigurator.vue     |   9 +
 .../posts/editor/RedditSettings.vue           | 385 ++++++++++++++++++
 2 files changed, 394 insertions(+)
 create mode 100644 resources/js/components/posts/editor/RedditSettings.vue

diff --git a/resources/js/components/ChannelConfigurator.vue b/resources/js/components/ChannelConfigurator.vue
index 5295d3db..b4e787f2 100644
--- a/resources/js/components/ChannelConfigurator.vue
+++ b/resources/js/components/ChannelConfigurator.vue
@@ -7,6 +7,7 @@ import FacebookSettings from '@/components/posts/editor/FacebookSettings.vue';
 import InstagramSettings from '@/components/posts/editor/InstagramSettings.vue';
 import LinkedInSettings from '@/components/posts/editor/LinkedInSettings.vue';
 import PinterestSettings from '@/components/posts/editor/PinterestSettings.vue';
+import RedditSettings from '@/components/posts/editor/RedditSettings.vue';
 import TikTokSettings from '@/components/posts/editor/TikTokSettings.vue';
 import { Avatar } from '@/components/ui/avatar';
 import { Badge } from '@/components/ui/badge';
@@ -177,6 +178,14 @@ const selectedChannels = computed(() => props.channels.filter((channel) => isSel
                 :preview-only="previewOnly"
                 @update:meta="emit('update:meta', channel.id, $event)"
             />
+            <RedditSettings
+                v-else-if="channel.platform === Platform.Reddit"
+                :social-account="channel.socialAccount"
+                :meta="channel.meta"
+                :disabled="disabled"
+                :preview-only="previewOnly"
+                @update:meta="emit('update:meta', channel.id, $event)"
+            />
         </template>
     </div>
 </template>
diff --git a/resources/js/components/posts/editor/RedditSettings.vue b/resources/js/components/posts/editor/RedditSettings.vue
new file mode 100644
index 00000000..d74c87f5
--- /dev/null
+++ b/resources/js/components/posts/editor/RedditSettings.vue
@@ -0,0 +1,385 @@
+<script setup lang="ts">
+import { useHttp } from '@inertiajs/vue3';
+import { IconChevronDown, IconChevronUp, IconPlus, IconTrash } from '@tabler/icons-vue';
+import { computed, onUnmounted, ref } from 'vue';
+
+import { restrictions as restrictionsRoute, subreddits as subredditsRoute } from '@/actions/App/Http/Controllers/App/RedditController';
+import InputError from '@/components/InputError.vue';
+import { Avatar } from '@/components/ui/avatar';
+import { Input } from '@/components/ui/input';
+import { usePageErrors } from '@/composables/usePageErrors';
+import { getPlatformLogo } from '@/composables/usePlatformLogo';
+
+interface SocialAccount {
+    id: string;
+    platform: string;
+    display_name: string;
+    username: string;
+    avatar_url: string | null;
+}
+
+interface SubredditResult {
+    name: string;
+    title: string;
+    subscribers: number;
+    over_18: boolean;
+}
+
+interface Flair {
+    id: string;
+    text: string;
+}
+
+interface SubredditRow {
+    name: string;
+    title: string;
+    type: 'self' | 'link' | 'image';
+    url?: string;
+    flair_id?: string;
+    flair_text?: string;
+    flair_required?: boolean;
+    allowed_types?: string[];
+    nsfw?: boolean;
+    spoiler?: boolean;
+}
+
+const props = withDefaults(
+    defineProps<{
+        socialAccount: SocialAccount | null;
+        meta: Record<string, any>;
+        disabled?: boolean;
+        previewOnly?: boolean;
+    }>(),
+    { disabled: false, previewOnly: false },
+);
+
+const emit = defineEmits<{ 'update:meta': [value: Record<string, any>] }>();
+
+const open = ref(false);
+
+const updateMeta = (patch: Record<string, any>) => emit('update:meta', { ...props.meta, ...patch });
+
+const subreddits = computed<SubredditRow[]>(() =>
+    Array.isArray(props.meta?.subreddits) ? (props.meta!.subreddits as SubredditRow[]) : [],
+);
+
+const updateSubreddits = (rows: SubredditRow[]) => updateMeta({ subreddits: rows });
+
+const updateRow = (index: number, patch: Partial<SubredditRow>) =>
+    updateSubreddits(subreddits.value.map((row, i) => (i === index ? { ...row, ...patch } : row)));
+
+const removeRow = (index: number) =>
+    updateSubreddits(subreddits.value.filter((_, i) => i !== index));
+
+const addRow = () =>
+    updateSubreddits([
+        ...subreddits.value,
+        { name: '', title: '', type: 'self', nsfw: false, spoiler: false },
+    ]);
+
+// --- Per-row flairs (local state, not persisted in meta) ---
+const rowFlairs = ref<Record<number, Flair[]>>({});
+
+const getFlairs = (index: number): Flair[] => rowFlairs.value[index] ?? [];
+
+// --- Subreddit search (per row) ---
+const searchQueries = ref<Record<number, string>>({});
+const searchResults = ref<Record<number, SubredditResult[]>>({});
+const searchLoading = ref<Record<number, boolean>>({});
+
+const subredditsHttp = useHttp<Record<string, never>, { data: SubredditResult[] }>();
+const restrictionsHttp = useHttp<Record<string, never>, { data: { allowed_types: string[]; flair_required: boolean; flairs: Flair[] } }>();
+
+const searchTimers: Record<number, ReturnType<typeof setTimeout>> = {};
+
+const searchSubreddits = (index: number, query: string) => {
+    searchQueries.value[index] = query;
+    clearTimeout(searchTimers[index]);
+
+    if (!props.socialAccount || query.trim() === '') {
+        searchResults.value[index] = [];
+        return;
+    }
+
+    searchTimers[index] = setTimeout(async () => {
+        searchLoading.value[index] = true;
+        try {
+            const { data } = await subredditsHttp.get(
+                subredditsRoute.url(props.socialAccount!.id, { query: { q: query } }),
+            );
+            searchResults.value[index] = data;
+        } catch {
+            searchResults.value[index] = [];
+        } finally {
+            searchLoading.value[index] = false;
+        }
+    }, 250);
+};
+
+const loadRestrictions = async (index: number, name: string) => {
+    if (!props.socialAccount || !name) {
+        return;
+    }
+
+    try {
+        const { data } = await restrictionsHttp.get(
+            restrictionsRoute.url({ account: props.socialAccount.id, subreddit: name }),
+        );
+
+        rowFlairs.value[index] = data.flairs;
+
+        const current = subreddits.value[index];
+        const allowedTypes = data.allowed_types;
+        const flairRequired = data.flair_required;
+        const currentType = current?.type ?? 'self';
+        const resolvedType = (allowedTypes.includes(currentType) ? currentType : allowedTypes[0] ?? 'self') as SubredditRow['type'];
+
+        updateRow(index, {
+            allowed_types: allowedTypes,
+            flair_required: flairRequired,
+            type: resolvedType,
+        });
+    } catch {
+        // silently fail; user can still proceed
+    }
+};
+
+const selectSubreddit = (index: number, result: SubredditResult) => {
+    searchQueries.value[index] = '';
+    searchResults.value[index] = [];
+
+    const current = subreddits.value[index] ?? {};
+    const title = current.title && current.title !== '' ? current.title : result.title;
+
+    updateRow(index, {
+        name: result.name,
+        title,
+        nsfw: result.over_18 ? true : (current.nsfw ?? false),
+    });
+
+    loadRestrictions(index, result.name);
+};
+
+const getAllowedTypes = (index: number): string[] => {
+    const row = subreddits.value[index];
+    return row?.allowed_types && row.allowed_types.length > 0 ? row.allowed_types : ['self', 'link', 'image'];
+};
+
+const typeLabels: Record<string, string> = {
+    self: 'posts.form.reddit.type_self',
+    link: 'posts.form.reddit.type_link',
+    image: 'posts.form.reddit.type_image',
+};
+
+// --- Error surfacing ---
+const errors = usePageErrors();
+
+const subredditError = (index: number): string | undefined =>
+    Object.entries(errors.value).find(([k]) => k.includes(`subreddits.${index}`) && !k.includes('.title') && !k.includes('.flair') && !k.includes('.url'))?.[1];
+
+const titleError = (index: number): string | undefined =>
+    Object.entries(errors.value).find(([k]) => k.includes(`subreddits.${index}.title`))?.[1];
+
+const flairError = (index: number): string | undefined =>
+    Object.entries(errors.value).find(([k]) => k.includes(`subreddits.${index}.flair`))?.[1];
+
+const urlError = (index: number): string | undefined =>
+    Object.entries(errors.value).find(([k]) => k.includes(`subreddits.${index}.url`))?.[1];
+
+onUnmounted(() => {
+    Object.values(searchTimers).forEach((t) => clearTimeout(t));
+});
+</script>
+
+<template>
+    <div class="rounded-xl border-2 border-foreground bg-card shadow-2xs">
+        <button
+            type="button"
+            class="flex w-full cursor-pointer items-center justify-between gap-3 p-4 text-sm"
+            @click="open = !open"
+        >
+            <span class="flex min-w-0 items-center gap-2">
+                <span class="inline-flex size-6 shrink-0 items-center justify-center overflow-hidden rounded-full border-2 border-foreground bg-card shadow-2xs">
+                    <img :src="getPlatformLogo('reddit')" alt="Reddit" class="size-full object-cover" />
+                </span>
+                <span class="truncate font-bold text-foreground">{{ $t('posts.form.reddit.settings') }}</span>
+                <span v-if="socialAccount?.display_name" class="truncate font-medium text-foreground/60">·&nbsp;{{ socialAccount.display_name }}</span>
+            </span>
+            <IconChevronUp v-if="open" class="size-4 shrink-0 text-foreground/60" />
+            <IconChevronDown v-else class="size-4 shrink-0 text-foreground/60" />
+        </button>
+
+        <div v-if="open" class="space-y-5 border-t-2 border-foreground/10 px-4 pb-4 pt-4">
+            <div v-if="socialAccount" class="flex items-center gap-3 rounded-lg bg-foreground/5 p-3">
+                <Avatar
+                    :src="socialAccount.avatar_url"
+                    :name="socialAccount.display_name"
+                    class="size-9 shrink-0 rounded-full border-2 border-foreground shadow-2xs"
+                />
+                <div class="min-w-0 flex-1">
+                    <p class="text-[11px] font-black uppercase tracking-widest text-foreground/60">{{ $t('posts.form.discord.posting_to') }}</p>
+                    <p class="truncate text-sm font-bold text-foreground">{{ socialAccount.display_name }}</p>
+                </div>
+            </div>
+
+            <!-- Subreddit rows -->
+            <div class="space-y-4">
+                <div
+                    v-for="(row, index) in subreddits"
+                    :key="index"
+                    class="space-y-3 rounded-lg border-2 border-foreground/20 p-3"
+                >
+                    <div class="flex items-center justify-between">
+                        <span class="text-[11px] font-black uppercase tracking-widest text-foreground/50">
+                            {{ $t('posts.form.reddit.subreddit') }} {{ index + 1 }}
+                        </span>
+                        <button
+                            type="button"
+                            :disabled="disabled"
+                            class="text-foreground/50 hover:text-rose-600 disabled:opacity-40"
+                            @click="removeRow(index)"
+                        >
+                            <IconTrash class="size-3.5" />
+                        </button>
+                    </div>
+
+                    <!-- Subreddit search -->
+                    <div class="space-y-1.5">
+                        <p class="text-[11px] font-black uppercase tracking-widest text-foreground/60">{{ $t('posts.form.reddit.subreddit') }}</p>
+                        <div class="relative">
+                            <Input
+                                :model-value="row.name !== '' ? (searchQueries[index] !== undefined ? searchQueries[index] : `r/${row.name}`) : (searchQueries[index] ?? '')"
+                                :disabled="disabled"
+                                :placeholder="$t('posts.form.reddit.search_subreddit')"
+                                @update:model-value="searchSubreddits(index, String($event))"
+                                @focus="searchQueries[index] = ''"
+                            />
+                            <ul
+                                v-if="searchResults[index] && searchResults[index].length > 0"
+                                class="absolute z-10 mt-1 max-h-48 w-full overflow-y-auto rounded-lg border-2 border-foreground bg-card shadow-2xs"
+                            >
+                                <li v-for="result in searchResults[index]" :key="result.name">
+                                    <button
+                                        type="button"
+                                        class="flex w-full cursor-pointer flex-col px-3 py-2 text-left hover:bg-foreground/5"
+                                        @click="selectSubreddit(index, result)"
+                                    >
+                                        <span class="text-sm font-semibold text-foreground">r/{{ result.name }}</span>
+                                        <span class="text-xs text-foreground/60">{{ result.title }}</span>
+                                    </button>
+                                </li>
+                            </ul>
+                        </div>
+                        <InputError :message="subredditError(index)" />
+                    </div>
+
+                    <!-- Title -->
+                    <div class="space-y-1.5">
+                        <p class="text-[11px] font-black uppercase tracking-widest text-foreground/60">{{ $t('posts.form.reddit.title') }}</p>
+                        <Input
+                            :model-value="row.title"
+                            :disabled="disabled"
+                            :placeholder="$t('posts.form.reddit.title')"
+                            @update:model-value="updateRow(index, { title: String($event) })"
+                        />
+                        <InputError :message="titleError(index)" />
+                    </div>
+
+                    <!-- Post type -->
+                    <div class="space-y-1.5">
+                        <p class="text-[11px] font-black uppercase tracking-widest text-foreground/60">{{ $t('posts.form.reddit.post_type') }}</p>
+                        <div class="flex gap-2">
+                            <button
+                                v-for="type in getAllowedTypes(index)"
+                                :key="type"
+                                type="button"
+                                :disabled="disabled"
+                                class="rounded-lg border-2 px-3 py-1.5 text-xs font-semibold transition-colors disabled:opacity-50"
+                                :class="row.type === type
+                                    ? 'border-foreground bg-foreground text-background'
+                                    : 'border-foreground/20 text-foreground/70 hover:border-foreground/50'"
+                                @click="updateRow(index, { type: type as SubredditRow['type'] })"
+                            >
+                                {{ $t(typeLabels[type] ?? type) }}
+                            </button>
+                        </div>
+                    </div>
+
+                    <!-- URL (link type only) -->
+                    <div v-if="row.type === 'link'" class="space-y-1.5">
+                        <p class="text-[11px] font-black uppercase tracking-widest text-foreground/60">{{ $t('posts.form.reddit.url') }}</p>
+                        <Input
+                            :model-value="row.url ?? ''"
+                            :disabled="disabled"
+                            :placeholder="$t('posts.form.reddit.url')"
+                            @update:model-value="updateRow(index, { url: String($event) })"
+                        />
+                        <InputError :message="urlError(index)" />
+                    </div>
+
+                    <!-- Flair -->
+                    <div v-if="getFlairs(index).length > 0 || row.flair_required" class="space-y-1.5">
+                        <p
+                            class="text-[11px] font-black uppercase tracking-widest"
+                            :class="row.flair_required ? 'text-foreground' : 'text-foreground/60'"
+                        >
+                            {{ $t('posts.form.reddit.flair') }}
+                            <span v-if="row.flair_required" class="text-rose-500">*</span>
+                        </p>
+                        <select
+                            :value="row.flair_id ?? ''"
+                            :disabled="disabled"
+                            class="w-full rounded-lg border-2 bg-card px-3 py-2 text-sm transition-colors hover:border-foreground focus:border-foreground focus:outline-none disabled:opacity-50"
+                            :class="flairError(index) ? 'border-rose-500' : (row.flair_required && !row.flair_id ? 'border-amber-400' : 'border-foreground/30')"
+                            @change="updateRow(index, {
+                                flair_id: ($event.target as HTMLSelectElement).value || undefined,
+                                flair_text: getFlairs(index).find((f) => f.id === ($event.target as HTMLSelectElement).value)?.text,
+                            })"
+                        >
+                            <option value="">{{ $t('posts.form.reddit.no_flair') }}</option>
+                            <option v-for="flair in getFlairs(index)" :key="flair.id" :value="flair.id">
+                                {{ flair.text }}
+                            </option>
+                        </select>
+                        <InputError :message="flairError(index)" />
+                    </div>
+
+                    <!-- NSFW + Spoiler -->
+                    <div class="flex gap-4">
+                        <label class="flex cursor-pointer items-center gap-2 text-sm font-medium text-foreground/80">
+                            <input
+                                type="checkbox"
+                                :checked="row.nsfw ?? false"
+                                :disabled="disabled"
+                                class="rounded border-2 border-foreground/30"
+                                @change="updateRow(index, { nsfw: ($event.target as HTMLInputElement).checked })"
+                            />
+                            {{ $t('posts.form.reddit.nsfw') }}
+                        </label>
+                        <label class="flex cursor-pointer items-center gap-2 text-sm font-medium text-foreground/80">
+                            <input
+                                type="checkbox"
+                                :checked="row.spoiler ?? false"
+                                :disabled="disabled"
+                                class="rounded border-2 border-foreground/30"
+                                @change="updateRow(index, { spoiler: ($event.target as HTMLInputElement).checked })"
+                            />
+                            {{ $t('posts.form.reddit.spoiler') }}
+                        </label>
+                    </div>
+                </div>
+
+                <!-- Add subreddit -->
+                <button
+                    type="button"
+                    :disabled="disabled"
+                    class="inline-flex cursor-pointer items-center gap-1 text-xs font-bold text-foreground/70 hover:text-foreground disabled:opacity-50"
+                    @click="addRow"
+                >
+                    <IconPlus class="size-3.5" />
+                    {{ $t('posts.form.reddit.add_subreddit') }}
+                </button>
+            </div>
+        </div>
+    </div>
+</template>

From 1033567d345d1cc1f97e8b02c808f2786232fa71 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Wed, 17 Jun 2026 12:32:06 -0300
Subject: [PATCH 20/34] feat(reddit): post preview

---
 .../posts/previews/PlatformPreview.vue        |   3 +
 .../posts/previews/RedditPreview.vue          | 171 ++++++++++++++++++
 2 files changed, 174 insertions(+)
 create mode 100644 resources/js/components/posts/previews/RedditPreview.vue

diff --git a/resources/js/components/posts/previews/PlatformPreview.vue b/resources/js/components/posts/previews/PlatformPreview.vue
index fee914f6..bf42e2b6 100644
--- a/resources/js/components/posts/previews/PlatformPreview.vue
+++ b/resources/js/components/posts/previews/PlatformPreview.vue
@@ -10,6 +10,7 @@ import InstagramPreview from './InstagramPreview.vue';
 import LinkedInPreview from './LinkedInPreview.vue';
 import MastodonPreview from './MastodonPreview.vue';
 import PinterestPreview from './PinterestPreview.vue';
+import RedditPreview from './RedditPreview.vue';
 import TelegramPreview from './TelegramPreview.vue';
 import ThreadsPreview from './ThreadsPreview.vue';
 import TikTokPreview from './TikTokPreview.vue';
@@ -71,6 +72,8 @@ const previewComponent = computed(() => {
             return TelegramPreview;
         case 'discord':
             return DiscordPreview;
+        case 'reddit':
+            return RedditPreview;
         default:
             return LinkedInPreview;
     }
diff --git a/resources/js/components/posts/previews/RedditPreview.vue b/resources/js/components/posts/previews/RedditPreview.vue
new file mode 100644
index 00000000..04b62fde
--- /dev/null
+++ b/resources/js/components/posts/previews/RedditPreview.vue
@@ -0,0 +1,171 @@
+<script setup lang="ts">
+import { computed } from 'vue';
+
+import VideoPreview from '@/components/posts/previews/VideoPreview.vue';
+import { isVideoMedia } from '@/composables/useMedia';
+import { getPlatformLogo } from '@/composables/usePlatformLogo';
+import type { MediaItem } from '@/types/media';
+
+interface SocialAccount {
+    id: string;
+    platform: string;
+    display_name: string;
+    username: string;
+    avatar_url: string | null;
+}
+
+interface SubredditRow {
+    name: string;
+    title: string;
+    type: 'self' | 'link' | 'image';
+    url?: string;
+    flair_id?: string;
+    flair_text?: string;
+    flair_required?: boolean;
+    allowed_types?: string[];
+    nsfw?: boolean;
+    spoiler?: boolean;
+}
+
+const props = defineProps<{
+    socialAccount: SocialAccount;
+    content: string;
+    media: MediaItem[];
+    meta?: Record<string, any>;
+}>();
+
+const subreddits = computed<SubredditRow[]>(() =>
+    Array.isArray(props.meta?.subreddits) ? (props.meta!.subreddits as SubredditRow[]) : [],
+);
+
+const firstSubreddit = computed<SubredditRow | null>(() => subreddits.value[0] ?? null);
+
+const subredditLabel = computed<string>(() => {
+    const first = firstSubreddit.value;
+    if (!first?.name) {
+        return 'r/subreddit';
+    }
+    const extra = subreddits.value.length - 1;
+    return extra > 0 ? `r/${first.name} +${extra} more` : `r/${first.name}`;
+});
+
+const postTitle = computed<string>(() => firstSubreddit.value?.title ?? '');
+
+const showNsfw = computed<boolean>(() => firstSubreddit.value?.nsfw === true);
+const showSpoiler = computed<boolean>(() => firstSubreddit.value?.spoiler === true);
+const flairText = computed<string>(() => firstSubreddit.value?.flair_text ?? '');
+
+const imageMedia = computed<MediaItem[]>(() => props.media.filter((item) => !isVideoMedia(item)));
+const videoMedia = computed<MediaItem | null>(() => props.media.find((item) => isVideoMedia(item)) ?? null);
+const showMedia = computed<boolean>(() => props.media.length > 0);
+</script>
+
+<template>
+    <div class="flex h-full w-full flex-col overflow-hidden bg-[#dae0e6]">
+        <!-- Subreddit header -->
+        <div class="flex items-center gap-2 bg-white px-4 py-2.5 shadow-sm">
+            <img :src="getPlatformLogo('reddit')" alt="Reddit" class="h-6 w-6 rounded-full object-cover" />
+            <span class="truncate text-[13px] font-bold text-[#FF4500]">{{ subredditLabel }}</span>
+        </div>
+
+        <!-- Post card -->
+        <div class="flex-1 overflow-y-auto p-3">
+            <div class="overflow-hidden rounded-md bg-white shadow-sm">
+                <!-- Vote rail + content -->
+                <div class="flex gap-0">
+                    <!-- Vote column -->
+                    <div class="flex w-10 shrink-0 flex-col items-center gap-1 bg-[#f8f9fa] px-2 py-3">
+                        <div class="text-[#FF4500]">▲</div>
+                        <span class="text-[11px] font-bold text-[#1c1c1c]">0</span>
+                        <div class="text-[#878a8c]">▼</div>
+                    </div>
+
+                    <!-- Main content -->
+                    <div class="min-w-0 flex-1 px-3 py-2">
+                        <!-- Meta row: author -->
+                        <div class="mb-1.5 flex items-center gap-1.5 text-[11px] text-[#878a8c]">
+                            <img
+                                v-if="socialAccount.avatar_url"
+                                :src="socialAccount.avatar_url"
+                                :alt="socialAccount.display_name"
+                                class="h-4 w-4 rounded-full object-cover"
+                            />
+                            <div
+                                v-else
+                                class="flex h-4 w-4 shrink-0 items-center justify-center rounded-full bg-[#FF4500] text-[8px] font-bold text-white"
+                            >
+                                {{ socialAccount.display_name?.charAt(0) }}
+                            </div>
+                            <span>u/{{ socialAccount.username || socialAccount.display_name || 'user' }}</span>
+                        </div>
+
+                        <!-- Title -->
+                        <p v-if="postTitle" class="mb-1.5 text-[15px] font-semibold leading-snug text-[#222222]">{{ postTitle }}</p>
+                        <p v-else class="mb-1.5 text-[15px] font-semibold italic leading-snug text-[#878a8c]">{{ $t('posts.form.reddit.title') }}</p>
+
+                        <!-- Tags row: NSFW, Spoiler, Flair -->
+                        <div v-if="showNsfw || showSpoiler || flairText" class="mb-1.5 flex flex-wrap items-center gap-1.5">
+                            <span
+                                v-if="showNsfw"
+                                class="rounded px-1.5 py-0.5 text-[10px] font-bold uppercase tracking-wide text-white"
+                                style="background-color: #ff585b"
+                            >NSFW</span>
+                            <span
+                                v-if="showSpoiler"
+                                class="rounded px-1.5 py-0.5 text-[10px] font-bold uppercase tracking-wide text-white"
+                                style="background-color: #7193ff"
+                            >Spoiler</span>
+                            <span
+                                v-if="flairText"
+                                class="rounded-full border border-[#FF4500] px-2 py-0.5 text-[10px] font-semibold text-[#FF4500]"
+                            >{{ flairText }}</span>
+                        </div>
+
+                        <!-- Body text -->
+                        <p v-if="content" class="whitespace-pre-wrap text-[14px] leading-[1.4] text-[#3c3c3c]">{{ content }}</p>
+
+                        <!-- Media (image type) -->
+                        <div v-if="showMedia" class="mt-2 overflow-hidden rounded">
+                            <div v-if="imageMedia.length > 0">
+                                <div
+                                    class="overflow-hidden"
+                                    :class="imageMedia.length >= 2 ? 'grid grid-cols-2 gap-0.5' : ''"
+                                >
+                                    <div
+                                        v-for="(item, index) in imageMedia.slice(0, 4)"
+                                        :key="item.id"
+                                        class="relative overflow-hidden"
+                                        :class="imageMedia.length === 1 ? 'aspect-[4/3]' : 'aspect-square'"
+                                    >
+                                        <img
+                                            :src="item.url"
+                                            :alt="item.original_filename"
+                                            class="h-full w-full object-cover"
+                                        />
+                                        <div
+                                            v-if="imageMedia.length > 4 && index === 3"
+                                            class="absolute inset-0 flex items-center justify-center bg-black/60"
+                                        >
+                                            <span class="text-xl font-semibold text-white">+{{ imageMedia.length - 4 }}</span>
+                                        </div>
+                                    </div>
+                                </div>
+                            </div>
+                            <VideoPreview
+                                v-else-if="videoMedia"
+                                :src="videoMedia.url"
+                                video-class="w-full max-h-72 object-cover bg-black"
+                            />
+                        </div>
+
+                        <!-- Action bar -->
+                        <div class="mt-2 flex items-center gap-3 text-[11px] font-bold text-[#878a8c]">
+                            <span>💬 0 Comments</span>
+                            <span>↗ Share</span>
+                        </div>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </div>
+</template>

From 622e364353d4c529faf47d3fe8e8009b77252f14 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Wed, 17 Jun 2026 12:35:35 -0300
Subject: [PATCH 21/34] feat(reddit): media optimizer profile for reddit images

---
 app/Services/Media/MediaOptimizer.php | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/app/Services/Media/MediaOptimizer.php b/app/Services/Media/MediaOptimizer.php
index 65de20e3..38ae9953 100644
--- a/app/Services/Media/MediaOptimizer.php
+++ b/app/Services/Media/MediaOptimizer.php
@@ -208,6 +208,12 @@ private function getImageConfig(Platform $platform): array
                 'format' => 'image/jpeg',
                 'quality' => 100,
             ],
+            Platform::Reddit => [
+                'max_width' => 2048,
+                'max_size' => 20 * 1024 * 1024,
+                'format' => 'image/jpeg',
+                'quality' => 100,
+            ],
         };
     }
 }

From 972bb3798295a44f87644f746f1bce208501e1b3 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Wed, 17 Jun 2026 12:46:23 -0300
Subject: [PATCH 22/34] fix(reddit): allow text-only posts, drop deferred
 video, profile url, dead rule

---
 app/Enums/PostPlatform/ContentType.php   |  3 ++-
 app/Enums/SocialAccount/Platform.php     |  2 +-
 app/Models/SocialAccount.php             |  1 +
 app/Support/PostPlatformMetaRules.php    |  2 +-
 tests/Feature/SocialAccountModelTest.php | 20 ++++++++++++++++++++
 tests/Unit/Enums/ContentTypeTest.php     |  2 ++
 tests/Unit/Enums/PlatformTest.php        |  2 +-
 7 files changed, 28 insertions(+), 4 deletions(-)

diff --git a/app/Enums/PostPlatform/ContentType.php b/app/Enums/PostPlatform/ContentType.php
index b544608b..b20a7913 100644
--- a/app/Enums/PostPlatform/ContentType.php
+++ b/app/Enums/PostPlatform/ContentType.php
@@ -206,7 +206,7 @@ public function supportsVideo(): bool
             self::MastodonPost => true,
             self::TelegramPost => true,
             self::DiscordMessage => true,
-            self::RedditPost => true,
+            self::RedditPost => false,
         };
     }
 
@@ -247,6 +247,7 @@ public function requiresMedia(): bool
             self::FacebookPost => false,
             self::InstagramFeed => false,
             self::DiscordMessage => false,
+            self::RedditPost => false,
             default => true,
         };
     }
diff --git a/app/Enums/SocialAccount/Platform.php b/app/Enums/SocialAccount/Platform.php
index 7cd2fe6b..30951fda 100644
--- a/app/Enums/SocialAccount/Platform.php
+++ b/app/Enums/SocialAccount/Platform.php
@@ -80,7 +80,7 @@ public function allowedMediaTypes(): array
             self::Mastodon => [MediaType::Image, MediaType::Video],
             self::Telegram => [MediaType::Image, MediaType::Video],
             self::Discord => [MediaType::Image, MediaType::Video],
-            self::Reddit => [MediaType::Image, MediaType::Video],
+            self::Reddit => [MediaType::Image],
         };
     }
 
diff --git a/app/Models/SocialAccount.php b/app/Models/SocialAccount.php
index d1fed6b6..0064d974 100644
--- a/app/Models/SocialAccount.php
+++ b/app/Models/SocialAccount.php
@@ -126,6 +126,7 @@ protected function profileUrl(): Attribute
                         ? rtrim((string) data_get($this->meta, 'instance'), '/')."/@{$username}"
                         : null,
                     SocialPlatform::Telegram => $username ? "https://t.me/{$username}" : null,
+                    SocialPlatform::Reddit => $username ? "https://www.reddit.com/user/{$username}" : null,
                     default => null,
                 };
             },
diff --git a/app/Support/PostPlatformMetaRules.php b/app/Support/PostPlatformMetaRules.php
index f408d989..11ba2af4 100644
--- a/app/Support/PostPlatformMetaRules.php
+++ b/app/Support/PostPlatformMetaRules.php
@@ -77,7 +77,7 @@ public static function rules(): array
             'platforms.*.meta.subreddits.*.name' => ['required', 'string'],
             'platforms.*.meta.subreddits.*.title' => ['required', 'string', 'max:300'],
             'platforms.*.meta.subreddits.*.type' => ['required', 'string', Rule::in(['self', 'link', 'image'])],
-            'platforms.*.meta.subreddits.*.url' => ['sometimes', 'nullable', 'url', 'required_if:platforms.*.meta.subreddits.*.type,link'],
+            'platforms.*.meta.subreddits.*.url' => ['sometimes', 'nullable', 'url'],
             'platforms.*.meta.subreddits.*.flair_id' => ['sometimes', 'nullable', 'string'],
             'platforms.*.meta.subreddits.*.flair_text' => ['sometimes', 'nullable', 'string'],
             'platforms.*.meta.subreddits.*.flair_required' => ['sometimes', 'boolean'],
diff --git a/tests/Feature/SocialAccountModelTest.php b/tests/Feature/SocialAccountModelTest.php
index d28bbf70..fbbfb1f5 100644
--- a/tests/Feature/SocialAccountModelTest.php
+++ b/tests/Feature/SocialAccountModelTest.php
@@ -186,3 +186,23 @@
     Event::assertDispatched(NotificationCreated::class);
     Mail::assertQueued(AccountDisconnected::class);
 });
+
+// ---- profileUrl ----
+
+test('reddit account profileUrl returns correct reddit user url', function () {
+    $account = SocialAccount::factory()->reddit()->create([
+        'workspace_id' => $this->workspace->id,
+        'username' => 'redditor_one',
+    ]);
+
+    expect($account->profileUrl)->toBe('https://www.reddit.com/user/redditor_one');
+});
+
+test('reddit account profileUrl returns null when username is blank', function () {
+    $account = SocialAccount::factory()->reddit()->create([
+        'workspace_id' => $this->workspace->id,
+        'username' => '',
+    ]);
+
+    expect($account->profileUrl)->toBeNull();
+});
diff --git a/tests/Unit/Enums/ContentTypeTest.php b/tests/Unit/Enums/ContentTypeTest.php
index ee543985..38c53af4 100644
--- a/tests/Unit/Enums/ContentTypeTest.php
+++ b/tests/Unit/Enums/ContentTypeTest.php
@@ -73,6 +73,7 @@
     expect(ContentType::YouTubeShort->supportsVideo())->toBeTrue();
     expect(ContentType::LinkedInCarousel->supportsVideo())->toBeFalse();
     expect(ContentType::PinterestPin->supportsVideo())->toBeFalse();
+    expect(ContentType::RedditPost->supportsVideo())->toBeFalse();
 });
 
 test('content type supports image correctly', function () {
@@ -97,6 +98,7 @@
     expect(ContentType::ThreadsPost->requiresMedia())->toBeFalse();
     expect(ContentType::BlueskyPost->requiresMedia())->toBeFalse();
     expect(ContentType::MastodonPost->requiresMedia())->toBeFalse();
+    expect(ContentType::RedditPost->requiresMedia())->toBeFalse();
 });
 
 test('can get content types for platform', function () {
diff --git a/tests/Unit/Enums/PlatformTest.php b/tests/Unit/Enums/PlatformTest.php
index 23adfe9f..2a263ff5 100644
--- a/tests/Unit/Enums/PlatformTest.php
+++ b/tests/Unit/Enums/PlatformTest.php
@@ -113,7 +113,7 @@
     expect(Platform::Reddit->value)->toBe('reddit')
         ->and(Platform::Reddit->label())->toBe('Reddit')
         ->and(Platform::Reddit->color())->toBe('#FF4500')
-        ->and(Platform::Reddit->allowedMediaTypes())->toBe([MediaType::Image, MediaType::Video])
+        ->and(Platform::Reddit->allowedMediaTypes())->toBe([MediaType::Image])
         ->and(Platform::Reddit->maxImages())->toBe(20)
         ->and(Platform::Reddit->maxContentLength())->toBe(40000)
         ->and(Platform::Reddit->recommendedAiContentLength())->toBe(500)

From 5be02b31ca511daa735ecc3eb772d27faf01ae22 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Wed, 17 Jun 2026 12:59:55 -0300
Subject: [PATCH 23/34] chore: remove competitor reference from media optimizer
 comment

---
 app/Services/Media/MediaOptimizer.php | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/app/Services/Media/MediaOptimizer.php b/app/Services/Media/MediaOptimizer.php
index 38ae9953..b1181c36 100644
--- a/app/Services/Media/MediaOptimizer.php
+++ b/app/Services/Media/MediaOptimizer.php
@@ -69,8 +69,8 @@ public function optimizeImage(string $filePath, Platform $platform): string
         file_put_contents($tempFile, (string) $encoded);
 
         // If still above the platform size budget, iteratively shrink DIMENSIONS
-        // (not quality) by 10 % per step until it fits. Postiz-style, preserves
-        // pixel quality while lowering the byte count.
+        // (not quality) by 10 % per step until it fits, preserving pixel quality
+        // while lowering the byte count.
         while (filesize($tempFile) > $maxSize) {
             $newWidth = (int) ($image->width() * 0.9);
             $newHeight = (int) ($image->height() * 0.9);

From c4b7537f34cf983798fa139be01a99bdc408673c Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Wed, 17 Jun 2026 13:16:27 -0300
Subject: [PATCH 24/34] fix(reddit): row-state alignment, debounce race,
 preview link/media gating, flair reload

---
 lang/en/posts.php                             |   2 +
 lang/es/posts.php                             |   2 +
 lang/pt-BR/posts.php                          |   2 +
 .../posts/editor/RedditSettings.vue           | 123 +++++++++++++-----
 .../posts/previews/RedditPreview.vue          |  20 ++-
 5 files changed, 118 insertions(+), 31 deletions(-)

diff --git a/lang/en/posts.php b/lang/en/posts.php
index 0c916543..f35ab489 100644
--- a/lang/en/posts.php
+++ b/lang/en/posts.php
@@ -183,6 +183,8 @@
         ],
         'reddit' => [
             'settings' => 'Reddit Settings',
+            'posting_to' => 'Posting to',
+            'searching' => 'Searching…',
             'add_subreddit' => 'Add subreddit',
             'remove_subreddit' => 'Remove',
             'subreddit' => 'Subreddit',
diff --git a/lang/es/posts.php b/lang/es/posts.php
index b36cf16d..27335f5a 100644
--- a/lang/es/posts.php
+++ b/lang/es/posts.php
@@ -183,6 +183,8 @@
         ],
         'reddit' => [
             'settings' => 'Configuración de Reddit',
+            'posting_to' => 'Publicando en',
+            'searching' => 'Buscando…',
             'add_subreddit' => 'Añadir subreddit',
             'remove_subreddit' => 'Quitar',
             'subreddit' => 'Subreddit',
diff --git a/lang/pt-BR/posts.php b/lang/pt-BR/posts.php
index 6905ed95..09e6b9ec 100644
--- a/lang/pt-BR/posts.php
+++ b/lang/pt-BR/posts.php
@@ -183,6 +183,8 @@
         ],
         'reddit' => [
             'settings' => 'Configurações do Reddit',
+            'posting_to' => 'Publicando em',
+            'searching' => 'Buscando…',
             'add_subreddit' => 'Adicionar subreddit',
             'remove_subreddit' => 'Remover',
             'subreddit' => 'Subreddit',
diff --git a/resources/js/components/posts/editor/RedditSettings.vue b/resources/js/components/posts/editor/RedditSettings.vue
index d74c87f5..0c984b8f 100644
--- a/resources/js/components/posts/editor/RedditSettings.vue
+++ b/resources/js/components/posts/editor/RedditSettings.vue
@@ -1,7 +1,7 @@
 <script setup lang="ts">
 import { useHttp } from '@inertiajs/vue3';
 import { IconChevronDown, IconChevronUp, IconPlus, IconTrash } from '@tabler/icons-vue';
-import { computed, onUnmounted, ref } from 'vue';
+import { computed, onUnmounted, ref, watch } from 'vue';
 
 import { restrictions as restrictionsRoute, subreddits as subredditsRoute } from '@/actions/App/Http/Controllers/App/RedditController';
 import InputError from '@/components/InputError.vue';
@@ -68,50 +68,96 @@ const updateSubreddits = (rows: SubredditRow[]) => updateMeta({ subreddits: rows
 const updateRow = (index: number, patch: Partial<SubredditRow>) =>
     updateSubreddits(subreddits.value.map((row, i) => (i === index ? { ...row, ...patch } : row)));
 
-const removeRow = (index: number) =>
+// --- Stable per-row IDs (Fix 1) ---
+// A parallel array of stable string IDs, one per subreddit row, keyed by row index.
+// These IDs are NOT persisted in meta — they live only in local component state.
+// All per-row dicts (rowFlairs, searchQueries, searchResults, searchLoading) are keyed
+// by these stable IDs so remove + reorder never cross-pollinate row state.
+let idCounter = 0;
+const nextId = () => `r-${++idCounter}`;
+
+const rowIds = ref<string[]>(subreddits.value.map(() => nextId()));
+
+// Keep rowIds in sync when subreddits grow externally (e.g. initial prop hydration).
+// We only add IDs for rows that don't have one yet; we never shrink rowIds here
+// because removeRow handles that explicitly.
+watch(
+    () => subreddits.value.length,
+    (newLen) => {
+        while (rowIds.value.length < newLen) {
+            rowIds.value.push(nextId());
+        }
+    },
+);
+
+const idFor = (index: number): string => {
+    if (!rowIds.value[index]) {
+        rowIds.value[index] = nextId();
+    }
+    return rowIds.value[index];
+};
+
+const removeRow = (index: number) => {
+    const removedId = rowIds.value[index];
+    rowIds.value = rowIds.value.filter((_, i) => i !== index);
+    // Drop the removed row's state from all per-row dicts.
+    delete rowFlairs.value[removedId];
+    delete searchQueries.value[removedId];
+    delete searchResults.value[removedId];
+    delete searchLoading.value[removedId];
     updateSubreddits(subreddits.value.filter((_, i) => i !== index));
+};
 
-const addRow = () =>
+const addRow = () => {
+    rowIds.value.push(nextId());
     updateSubreddits([
         ...subreddits.value,
         { name: '', title: '', type: 'self', nsfw: false, spoiler: false },
     ]);
+};
 
-// --- Per-row flairs (local state, not persisted in meta) ---
-const rowFlairs = ref<Record<number, Flair[]>>({});
+// --- Per-row flairs (keyed by stable row ID, Fix 1) ---
+const rowFlairs = ref<Record<string, Flair[]>>({});
 
-const getFlairs = (index: number): Flair[] => rowFlairs.value[index] ?? [];
+const getFlairs = (index: number): Flair[] => rowFlairs.value[idFor(index)] ?? [];
 
-// --- Subreddit search (per row) ---
-const searchQueries = ref<Record<number, string>>({});
-const searchResults = ref<Record<number, SubredditResult[]>>({});
-const searchLoading = ref<Record<number, boolean>>({});
+// --- Subreddit search (per row, keyed by stable row ID, Fix 1) ---
+const searchQueries = ref<Record<string, string>>({});
+const searchResults = ref<Record<string, SubredditResult[]>>({});
+const searchLoading = ref<Record<string, boolean>>({});
 
 const subredditsHttp = useHttp<Record<string, never>, { data: SubredditResult[] }>();
 const restrictionsHttp = useHttp<Record<string, never>, { data: { allowed_types: string[]; flair_required: boolean; flairs: Flair[] } }>();
 
-const searchTimers: Record<number, ReturnType<typeof setTimeout>> = {};
+const searchTimers: Record<string, ReturnType<typeof setTimeout>> = {};
 
 const searchSubreddits = (index: number, query: string) => {
-    searchQueries.value[index] = query;
-    clearTimeout(searchTimers[index]);
+    const id = idFor(index);
+    searchQueries.value[id] = query;
+    clearTimeout(searchTimers[id]);
 
     if (!props.socialAccount || query.trim() === '') {
-        searchResults.value[index] = [];
+        searchResults.value[id] = [];
         return;
     }
 
-    searchTimers[index] = setTimeout(async () => {
-        searchLoading.value[index] = true;
+    searchTimers[id] = setTimeout(async () => {
+        // Fix 2: re-check socialAccount inside the debounce callback to guard against it
+        // being cleared during the 250 ms window.
+        if (!props.socialAccount) {
+            searchLoading.value[id] = false;
+            return;
+        }
+        searchLoading.value[id] = true;
         try {
             const { data } = await subredditsHttp.get(
-                subredditsRoute.url(props.socialAccount!.id, { query: { q: query } }),
+                subredditsRoute.url(props.socialAccount.id, { query: { q: query } }),
             );
-            searchResults.value[index] = data;
+            searchResults.value[id] = data;
         } catch {
-            searchResults.value[index] = [];
+            searchResults.value[id] = [];
         } finally {
-            searchLoading.value[index] = false;
+            searchLoading.value[id] = false;
         }
     }, 250);
 };
@@ -121,12 +167,14 @@ const loadRestrictions = async (index: number, name: string) => {
         return;
     }
 
+    const id = idFor(index);
+
     try {
         const { data } = await restrictionsHttp.get(
             restrictionsRoute.url({ account: props.socialAccount.id, subreddit: name }),
         );
 
-        rowFlairs.value[index] = data.flairs;
+        rowFlairs.value[id] = data.flairs;
 
         const current = subreddits.value[index];
         const allowedTypes = data.allowed_types;
@@ -144,9 +192,23 @@ const loadRestrictions = async (index: number, name: string) => {
     }
 };
 
+// Fix 4: when the panel opens, repopulate flairs for any persisted rows that
+// already have a subreddit name selected (e.g. editing an existing post).
+watch(open, (isOpen) => {
+    if (!isOpen || props.previewOnly || props.disabled) {
+        return;
+    }
+    subreddits.value.forEach((row, index) => {
+        if (row.name) {
+            loadRestrictions(index, row.name);
+        }
+    });
+});
+
 const selectSubreddit = (index: number, result: SubredditResult) => {
-    searchQueries.value[index] = '';
-    searchResults.value[index] = [];
+    const id = idFor(index);
+    searchQueries.value[id] = '';
+    searchResults.value[id] = [];
 
     const current = subreddits.value[index] ?? {};
     const title = current.title && current.title !== '' ? current.title : result.title;
@@ -217,7 +279,8 @@ onUnmounted(() => {
                     class="size-9 shrink-0 rounded-full border-2 border-foreground shadow-2xs"
                 />
                 <div class="min-w-0 flex-1">
-                    <p class="text-[11px] font-black uppercase tracking-widest text-foreground/60">{{ $t('posts.form.discord.posting_to') }}</p>
+                    <!-- Fix 5: use reddit-owned key instead of discord's -->
+                    <p class="text-[11px] font-black uppercase tracking-widest text-foreground/60">{{ $t('posts.form.reddit.posting_to') }}</p>
                     <p class="truncate text-sm font-bold text-foreground">{{ socialAccount.display_name }}</p>
                 </div>
             </div>
@@ -226,7 +289,7 @@ onUnmounted(() => {
             <div class="space-y-4">
                 <div
                     v-for="(row, index) in subreddits"
-                    :key="index"
+                    :key="idFor(index)"
                     class="space-y-3 rounded-lg border-2 border-foreground/20 p-3"
                 >
                     <div class="flex items-center justify-between">
@@ -248,17 +311,19 @@ onUnmounted(() => {
                         <p class="text-[11px] font-black uppercase tracking-widest text-foreground/60">{{ $t('posts.form.reddit.subreddit') }}</p>
                         <div class="relative">
                             <Input
-                                :model-value="row.name !== '' ? (searchQueries[index] !== undefined ? searchQueries[index] : `r/${row.name}`) : (searchQueries[index] ?? '')"
+                                :model-value="row.name !== '' ? (searchQueries[idFor(index)] !== undefined ? searchQueries[idFor(index)] : `r/${row.name}`) : (searchQueries[idFor(index)] ?? '')"
                                 :disabled="disabled"
                                 :placeholder="$t('posts.form.reddit.search_subreddit')"
                                 @update:model-value="searchSubreddits(index, String($event))"
-                                @focus="searchQueries[index] = ''"
+                                @focus="searchQueries[idFor(index)] = ''"
                             />
+                            <!-- Fix 6: loading indicator while searching -->
+                            <p v-if="searchLoading[idFor(index)]" class="mt-1 text-xs text-foreground/50">{{ $t('posts.form.reddit.searching') }}</p>
                             <ul
-                                v-if="searchResults[index] && searchResults[index].length > 0"
+                                v-if="searchResults[idFor(index)] && searchResults[idFor(index)].length > 0"
                                 class="absolute z-10 mt-1 max-h-48 w-full overflow-y-auto rounded-lg border-2 border-foreground bg-card shadow-2xs"
                             >
-                                <li v-for="result in searchResults[index]" :key="result.name">
+                                <li v-for="result in searchResults[idFor(index)]" :key="result.name">
                                     <button
                                         type="button"
                                         class="flex w-full cursor-pointer flex-col px-3 py-2 text-left hover:bg-foreground/5"
diff --git a/resources/js/components/posts/previews/RedditPreview.vue b/resources/js/components/posts/previews/RedditPreview.vue
index 04b62fde..0833dcda 100644
--- a/resources/js/components/posts/previews/RedditPreview.vue
+++ b/resources/js/components/posts/previews/RedditPreview.vue
@@ -57,7 +57,14 @@ const flairText = computed<string>(() => firstSubreddit.value?.flair_text ?? '')
 
 const imageMedia = computed<MediaItem[]>(() => props.media.filter((item) => !isVideoMedia(item)));
 const videoMedia = computed<MediaItem | null>(() => props.media.find((item) => isVideoMedia(item)) ?? null);
-const showMedia = computed<boolean>(() => props.media.length > 0);
+
+// Fix 3: only show uploaded media for image-type posts; self/link posts must not render images.
+const showMedia = computed<boolean>(() => firstSubreddit.value?.type === 'image' && props.media.length > 0);
+
+// Fix 3: render the link URL for link-type posts.
+const linkUrl = computed<string | null>(() =>
+    firstSubreddit.value?.type === 'link' && firstSubreddit.value?.url ? firstSubreddit.value.url : null,
+);
 </script>
 
 <template>
@@ -124,7 +131,16 @@ const showMedia = computed<boolean>(() => props.media.length > 0);
                         <!-- Body text -->
                         <p v-if="content" class="whitespace-pre-wrap text-[14px] leading-[1.4] text-[#3c3c3c]">{{ content }}</p>
 
-                        <!-- Media (image type) -->
+                        <!-- Link URL pill (link-type posts only, Fix 3) -->
+                        <a
+                            v-if="linkUrl"
+                            :href="linkUrl"
+                            target="_blank"
+                            rel="noopener noreferrer"
+                            class="mt-2 inline-flex max-w-full items-center truncate rounded border border-[#878a8c]/40 bg-[#f8f9fa] px-2 py-0.5 text-[11px] text-[#0079d3] hover:underline"
+                        >{{ linkUrl }}</a>
+
+                        <!-- Media (image type only, Fix 3) -->
                         <div v-if="showMedia" class="mt-2 overflow-hidden rounded">
                             <div v-if="imageMedia.length > 0">
                                 <div

From e1170cad88f81c9a260522d9581a34bc2db34db1 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Wed, 17 Jun 2026 13:18:11 -0300
Subject: [PATCH 25/34] fix(reddit): rescue lookup endpoints, data_get karma,
 array-cast token response, config host in test

---
 app/Http/Controllers/App/RedditController.php      | 14 ++++++++++++--
 app/Services/Social/Reddit/RedditAnalytics.php     |  2 +-
 app/Socialite/RedditProvider.php                   |  2 +-
 .../Services/Social/RedditAnalyticsTest.php        |  8 ++++----
 4 files changed, 18 insertions(+), 8 deletions(-)

diff --git a/app/Http/Controllers/App/RedditController.php b/app/Http/Controllers/App/RedditController.php
index 18b6a90a..f30aa624 100644
--- a/app/Http/Controllers/App/RedditController.php
+++ b/app/Http/Controllers/App/RedditController.php
@@ -23,7 +23,11 @@ public function subreddits(Request $request, SocialAccount $account): JsonRespon
         $query = trim((string) $request->query('q', ''));
 
         return response()->json([
-            'data' => $query === '' ? [] : $this->client->searchSubreddits($account, $query),
+            'data' => $query === '' ? [] : rescue(
+                fn () => $this->client->searchSubreddits($account, $query),
+                [],
+                report: false,
+            ),
         ]);
     }
 
@@ -31,7 +35,13 @@ public function restrictions(Request $request, SocialAccount $account, string $s
     {
         $this->authorizeRedditAccount($request, $account);
 
-        return response()->json(['data' => $this->client->restrictions($account, $subreddit)]);
+        return response()->json([
+            'data' => rescue(
+                fn () => $this->client->restrictions($account, $subreddit),
+                ['allowed_types' => ['self', 'link', 'image'], 'flair_required' => false, 'flairs' => []],
+                report: false,
+            ),
+        ]);
     }
 
     private function authorizeRedditAccount(Request $request, SocialAccount $account): void
diff --git a/app/Services/Social/Reddit/RedditAnalytics.php b/app/Services/Social/Reddit/RedditAnalytics.php
index 99bc8bce..c678b7b2 100644
--- a/app/Services/Social/Reddit/RedditAnalytics.php
+++ b/app/Services/Social/Reddit/RedditAnalytics.php
@@ -30,7 +30,7 @@ public function getMetrics(SocialAccount $account): array
         }
 
         return [
-            ['label' => __('analytics.metrics.karma'), 'value' => $karma['total_karma']],
+            ['label' => __('analytics.metrics.karma'), 'value' => data_get($karma, 'total_karma', 0)],
         ];
     }
 
diff --git a/app/Socialite/RedditProvider.php b/app/Socialite/RedditProvider.php
index 1c55347b..7540be0a 100644
--- a/app/Socialite/RedditProvider.php
+++ b/app/Socialite/RedditProvider.php
@@ -59,7 +59,7 @@ public function getAccessTokenResponse($code): array
             ],
         ]);
 
-        return json_decode((string) $response->getBody(), true);
+        return (array) json_decode((string) $response->getBody(), true);
     }
 
     /**
diff --git a/tests/Feature/Services/Social/RedditAnalyticsTest.php b/tests/Feature/Services/Social/RedditAnalyticsTest.php
index 3b1fb37b..842ee161 100644
--- a/tests/Feature/Services/Social/RedditAnalyticsTest.php
+++ b/tests/Feature/Services/Social/RedditAnalyticsTest.php
@@ -18,7 +18,7 @@
 });
 
 test('post metrics sum score and comments across subreddits', function () {
-    Http::fake(['https://oauth.reddit.com/api/info*' => Http::response(['data' => ['children' => [
+    Http::fake([config('trypost.platforms.reddit.api').'/api/info*' => Http::response(['data' => ['children' => [
         ['data' => ['name' => 't3_one', 'score' => 10, 'num_comments' => 3]],
         ['data' => ['name' => 't3_two', 'score' => 5, 'num_comments' => 2]],
     ]]], 200)]);
@@ -36,7 +36,7 @@
 });
 
 test('account metrics expose total karma', function () {
-    Http::fake(['https://oauth.reddit.com/api/v1/me*' => Http::response(['total_karma' => 1234, 'link_karma' => 1000, 'comment_karma' => 234], 200)]);
+    Http::fake([config('trypost.platforms.reddit.api').'/api/v1/me*' => Http::response(['total_karma' => 1234, 'link_karma' => 1000, 'comment_karma' => 234], 200)]);
 
     $metrics = app(RedditAnalytics::class)->getMetrics($this->account);
 
@@ -53,7 +53,7 @@
 });
 
 test('post metrics return empty when info API returns no children', function () {
-    Http::fake(['https://oauth.reddit.com/api/info*' => Http::response(['data' => ['children' => []]], 200)]);
+    Http::fake([config('trypost.platforms.reddit.api').'/api/info*' => Http::response(['data' => ['children' => []]], 200)]);
 
     $platform = PostPlatform::factory()->reddit()->create([
         'social_account_id' => $this->account->id,
@@ -64,7 +64,7 @@
 });
 
 test('account metrics return empty when me API throws a connection exception', function () {
-    Http::fake(['https://oauth.reddit.com/api/v1/me*' => fn () => throw new ConnectionException('timeout')]);
+    Http::fake([config('trypost.platforms.reddit.api').'/api/v1/me*' => fn () => throw new ConnectionException('timeout')]);
 
     $account = SocialAccount::factory()->reddit()->create(['workspace_id' => $this->account->workspace_id]);
 

From 1a14b0eb8812a04d866a1e335eb019addd9c0598 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Wed, 17 Jun 2026 13:24:45 -0300
Subject: [PATCH 26/34] test(reddit): cover required-on-publish branches,
 media/oauth/client failure paths, dispatch

---
 tests/Feature/Api/PostApiPlatformMetaTest.php | 57 +++++++++++++++++
 .../Jobs/PublishToSocialPlatformTest.php      | 26 ++++++++
 .../Feature/Mcp/PostPlatformMetaToolTest.php  | 63 +++++++++++++++++++
 .../Social/ConnectionVerifierRedditTest.php   | 13 ++++
 .../Services/Social/RedditClientTest.php      | 45 +++++++++++++
 .../Services/Social/RedditPublisherTest.php   | 36 +++++++++++
 tests/Feature/UpdatePostRequestTest.php       | 61 ++++++++++++++++++
 tests/Unit/Enums/ContentTypeTest.php          | 15 +++++
 .../ContentTypeCompatibleWithMediaTest.php    | 13 ++++
 tests/Unit/Socialite/RedditProviderTest.php   | 46 +++++++++++++-
 10 files changed, 374 insertions(+), 1 deletion(-)

diff --git a/tests/Feature/Api/PostApiPlatformMetaTest.php b/tests/Feature/Api/PostApiPlatformMetaTest.php
index 5318b0a5..4cc8c426 100644
--- a/tests/Feature/Api/PostApiPlatformMetaTest.php
+++ b/tests/Feature/Api/PostApiPlatformMetaTest.php
@@ -195,3 +195,60 @@
         ->assertUnprocessable()
         ->assertJsonValidationErrors(['platforms.0.meta.subreddits']);
 });
+
+it('rejects publishing a Reddit post where a subreddit has a blank title', function () {
+    $account = SocialAccount::factory()->reddit()->create(['workspace_id' => $this->workspace->id]);
+    $post = Post::factory()->create(['workspace_id' => $this->workspace->id, 'user_id' => $this->user->id]);
+    $platform = PostPlatform::factory()->reddit()->create([
+        'post_id' => $post->id,
+        'social_account_id' => $account->id,
+        'enabled' => true,
+        'meta' => ['subreddits' => [['name' => 'AskReddit', 'title' => '', 'type' => 'self']]],
+    ]);
+
+    $this->withHeaders($this->headers)
+        ->putJson(route('api.posts.update', $post), [
+            'status' => PostStatus::Publishing->value,
+            'platforms' => [['id' => $platform->id]],
+        ])
+        ->assertUnprocessable()
+        ->assertJsonValidationErrors(['platforms.0.meta.subreddits']);
+});
+
+it('rejects publishing a Reddit link post with no url', function () {
+    $account = SocialAccount::factory()->reddit()->create(['workspace_id' => $this->workspace->id]);
+    $post = Post::factory()->create(['workspace_id' => $this->workspace->id, 'user_id' => $this->user->id]);
+    $platform = PostPlatform::factory()->reddit()->create([
+        'post_id' => $post->id,
+        'social_account_id' => $account->id,
+        'enabled' => true,
+        'meta' => ['subreddits' => [['name' => 'AskReddit', 'title' => 'My Link', 'type' => 'link', 'url' => null]]],
+    ]);
+
+    $this->withHeaders($this->headers)
+        ->putJson(route('api.posts.update', $post), [
+            'status' => PostStatus::Publishing->value,
+            'platforms' => [['id' => $platform->id]],
+        ])
+        ->assertUnprocessable()
+        ->assertJsonValidationErrors(['platforms.0.meta.subreddits']);
+});
+
+it('rejects publishing a Reddit post where flair is required but missing', function () {
+    $account = SocialAccount::factory()->reddit()->create(['workspace_id' => $this->workspace->id]);
+    $post = Post::factory()->create(['workspace_id' => $this->workspace->id, 'user_id' => $this->user->id]);
+    $platform = PostPlatform::factory()->reddit()->create([
+        'post_id' => $post->id,
+        'social_account_id' => $account->id,
+        'enabled' => true,
+        'meta' => ['subreddits' => [['name' => 'AskReddit', 'title' => 'My Post', 'type' => 'self', 'flair_required' => true]]],
+    ]);
+
+    $this->withHeaders($this->headers)
+        ->putJson(route('api.posts.update', $post), [
+            'status' => PostStatus::Publishing->value,
+            'platforms' => [['id' => $platform->id]],
+        ])
+        ->assertUnprocessable()
+        ->assertJsonValidationErrors(['platforms.0.meta.subreddits']);
+});
diff --git a/tests/Feature/Jobs/PublishToSocialPlatformTest.php b/tests/Feature/Jobs/PublishToSocialPlatformTest.php
index 92abd65a..68bf272c 100644
--- a/tests/Feature/Jobs/PublishToSocialPlatformTest.php
+++ b/tests/Feature/Jobs/PublishToSocialPlatformTest.php
@@ -20,6 +20,7 @@
 use App\Models\Workspace;
 use App\Services\Social\ConnectionVerifier;
 use App\Services\Social\LinkedInPublisher;
+use App\Services\Social\Reddit\RedditPublisher;
 use Carbon\Carbon;
 use Illuminate\Support\Facades\Bus;
 use Illuminate\Support\Facades\Event;
@@ -626,3 +627,28 @@
     expect($this->postPlatform->error_context['category'])->toBe('token_expired');
     expect($this->postPlatform->error_context['platform_error_code'])->toBe('190');
 });
+
+test('a Reddit PostPlatform is routed to RedditPublisher', function () {
+    Event::fake();
+
+    $redditAccount = SocialAccount::factory()->reddit()->create(['workspace_id' => $this->workspace->id]);
+    $redditPlatform = PostPlatform::factory()->reddit()->create([
+        'post_id' => $this->post->id,
+        'social_account_id' => $redditAccount->id,
+        'enabled' => true,
+    ]);
+
+    $publisher = Mockery::mock(RedditPublisher::class);
+    $publisher->shouldReceive('publish')->once()->andReturn([
+        'id' => 'reddit-123',
+        'url' => 'https://www.reddit.com/r/test/comments/reddit-123/',
+    ]);
+
+    $this->app->instance(RedditPublisher::class, $publisher);
+
+    (new PublishToSocialPlatform($redditPlatform))->handle();
+
+    $redditPlatform->refresh();
+    expect($redditPlatform->status)->toBe(PlatformStatus::Published)
+        ->and($redditPlatform->platform_post_id)->toBe('reddit-123');
+});
diff --git a/tests/Feature/Mcp/PostPlatformMetaToolTest.php b/tests/Feature/Mcp/PostPlatformMetaToolTest.php
index 69f13157..a8c2dda8 100644
--- a/tests/Feature/Mcp/PostPlatformMetaToolTest.php
+++ b/tests/Feature/Mcp/PostPlatformMetaToolTest.php
@@ -222,3 +222,66 @@
 
     $response->assertHasErrors([__('posts.form.reddit.subreddit_required')]);
 });
+
+test('publish post rejects a Reddit platform where a subreddit has a blank title', function () {
+    $account = SocialAccount::factory()->reddit()->create(['workspace_id' => $this->workspace->id]);
+
+    $post = Post::factory()->create([
+        'workspace_id' => $this->workspace->id,
+        'user_id' => $this->user->id,
+        'status' => PostStatus::Draft,
+    ]);
+    PostPlatform::factory()->reddit()->create([
+        'post_id' => $post->id,
+        'social_account_id' => $account->id,
+        'enabled' => true,
+        'meta' => ['subreddits' => [['name' => 'AskReddit', 'title' => '', 'type' => 'self']]],
+    ]);
+
+    $response = TryPostServer::actingAs($this->user)
+        ->tool(PublishPostTool::class, ['post_id' => $post->id]);
+
+    $response->assertHasErrors([__('posts.form.reddit.title_required')]);
+});
+
+test('publish post rejects a Reddit link platform with no url', function () {
+    $account = SocialAccount::factory()->reddit()->create(['workspace_id' => $this->workspace->id]);
+
+    $post = Post::factory()->create([
+        'workspace_id' => $this->workspace->id,
+        'user_id' => $this->user->id,
+        'status' => PostStatus::Draft,
+    ]);
+    PostPlatform::factory()->reddit()->create([
+        'post_id' => $post->id,
+        'social_account_id' => $account->id,
+        'enabled' => true,
+        'meta' => ['subreddits' => [['name' => 'AskReddit', 'title' => 'My Link', 'type' => 'link', 'url' => null]]],
+    ]);
+
+    $response = TryPostServer::actingAs($this->user)
+        ->tool(PublishPostTool::class, ['post_id' => $post->id]);
+
+    $response->assertHasErrors([__('posts.form.reddit.url_required')]);
+});
+
+test('publish post rejects a Reddit platform where flair is required but missing', function () {
+    $account = SocialAccount::factory()->reddit()->create(['workspace_id' => $this->workspace->id]);
+
+    $post = Post::factory()->create([
+        'workspace_id' => $this->workspace->id,
+        'user_id' => $this->user->id,
+        'status' => PostStatus::Draft,
+    ]);
+    PostPlatform::factory()->reddit()->create([
+        'post_id' => $post->id,
+        'social_account_id' => $account->id,
+        'enabled' => true,
+        'meta' => ['subreddits' => [['name' => 'AskReddit', 'title' => 'My Post', 'type' => 'self', 'flair_required' => true]]],
+    ]);
+
+    $response = TryPostServer::actingAs($this->user)
+        ->tool(PublishPostTool::class, ['post_id' => $post->id]);
+
+    $response->assertHasErrors([__('posts.form.reddit.flair_required')]);
+});
diff --git a/tests/Feature/Services/Social/ConnectionVerifierRedditTest.php b/tests/Feature/Services/Social/ConnectionVerifierRedditTest.php
index 319f94f2..5b7f230c 100644
--- a/tests/Feature/Services/Social/ConnectionVerifierRedditTest.php
+++ b/tests/Feature/Services/Social/ConnectionVerifierRedditTest.php
@@ -35,6 +35,19 @@
         ->toThrow(TokenExpiredException::class, 'Reddit access token is invalid or expired');
 });
 
+test('throws TokenExpiredException when reddit verify returns 403', function () {
+    Http::fake([
+        config('trypost.platforms.reddit.api').'/api/v1/me' => Http::response([], 403),
+    ]);
+
+    $account = SocialAccount::factory()->reddit()->create([
+        'token_expires_at' => now()->addDays(30),
+    ]);
+
+    expect(fn () => (new ConnectionVerifier)->verify($account))
+        ->toThrow(TokenExpiredException::class, 'Reddit access token is invalid or expired');
+});
+
 test('refreshing a reddit token stores the new access token', function () {
     Http::fake([
         config('trypost.platforms.reddit.oauth_api').'/access_token' => Http::response([
diff --git a/tests/Feature/Services/Social/RedditClientTest.php b/tests/Feature/Services/Social/RedditClientTest.php
index e2d898e0..6646cadc 100644
--- a/tests/Feature/Services/Social/RedditClientTest.php
+++ b/tests/Feature/Services/Social/RedditClientTest.php
@@ -5,6 +5,7 @@
 use App\Models\SocialAccount;
 use App\Models\Workspace;
 use App\Services\Social\Reddit\RedditClient;
+use Illuminate\Http\Client\ConnectionException;
 use Illuminate\Support\Facades\Http;
 
 beforeEach(function () {
@@ -67,6 +68,50 @@
         ->not->toContain('video')->not->toContain('gallery');
 });
 
+test('restrictions returns only link type when submission_type is link and images not allowed', function () {
+    Http::fake([
+        'https://oauth.reddit.com/r/AnnounceOnly/about*' => Http::response([
+            'data' => ['submission_type' => 'link', 'allow_images' => false],
+        ], 200),
+        'https://oauth.reddit.com/api/v1/AnnounceOnly/post_requirements*' => Http::response([
+            'is_flair_required' => false,
+        ], 200),
+        'https://oauth.reddit.com/r/AnnounceOnly/api/link_flair_v2*' => Http::response([], 200),
+    ]);
+
+    $r = app(RedditClient::class)->restrictions($this->account, 'AnnounceOnly');
+
+    expect($r['allowed_types'])->toBe(['link'])
+        ->not->toContain('self')
+        ->not->toContain('image');
+});
+
+test('flairs returns empty array when the flair endpoint throws a connection exception', function () {
+    Http::fake([
+        'https://oauth.reddit.com/r/AskReddit/api/link_flair_v2*' => fn () => throw new ConnectionException('Connection refused'),
+    ]);
+
+    $flairs = app(RedditClient::class)->flairs($this->account, 'AskReddit');
+
+    expect($flairs)->toBe([]);
+});
+
+test('restrictions returns empty flairs array when the flair endpoint throws a connection exception', function () {
+    Http::fake([
+        'https://oauth.reddit.com/r/AskReddit/about*' => Http::response([
+            'data' => ['submission_type' => 'any', 'allow_images' => false],
+        ], 200),
+        'https://oauth.reddit.com/api/v1/AskReddit/post_requirements*' => Http::response([
+            'is_flair_required' => true,
+        ], 200),
+        'https://oauth.reddit.com/r/AskReddit/api/link_flair_v2*' => fn () => throw new ConnectionException('Connection refused'),
+    ]);
+
+    $r = app(RedditClient::class)->restrictions($this->account, 'AskReddit');
+
+    expect($r['flairs'])->toBe([]);
+});
+
 test('info sums nothing for empty fullnames and maps children otherwise', function () {
     Http::fake([
         'https://oauth.reddit.com/api/info*' => Http::response([
diff --git a/tests/Feature/Services/Social/RedditPublisherTest.php b/tests/Feature/Services/Social/RedditPublisherTest.php
index e8b1965b..a7a04b47 100644
--- a/tests/Feature/Services/Social/RedditPublisherTest.php
+++ b/tests/Feature/Services/Social/RedditPublisherTest.php
@@ -146,6 +146,42 @@ function redditPlatform(array $subreddits): PostPlatform
     }
 });
 
+test('throws when an image post has no media attached', function () {
+    $platform = redditPlatform([['name' => 'pics', 'title' => 'My photo', 'type' => 'image']]);
+
+    expect(fn () => app(RedditPublisher::class)->publish($platform))
+        ->toThrow(RedditPublishException::class);
+});
+
+test('throws when s3 upload returns a non-2xx status', function () {
+    test()->post->update([
+        'media' => [[
+            'id' => 'm2',
+            'path' => 'media/2026-01/photo.jpg',
+            'url' => 'https://cdn.test/photo.jpg',
+            'mime_type' => 'image/jpeg',
+            'original_filename' => 'photo.jpg',
+        ]],
+    ]);
+
+    Http::fake([
+        'https://oauth.reddit.com/api/media/asset*' => Http::response([
+            'args' => [
+                'action' => '//reddit-uploads.s3.amazonaws.com',
+                'fields' => [['name' => 'key', 'value' => 'abc/photo.jpg']],
+            ],
+            'asset' => ['asset_id' => 'a1'],
+        ], 200),
+        'https://cdn.test/photo.jpg' => Http::response('binarybytes', 200),
+        'https://reddit-uploads.s3.amazonaws.com' => Http::response('Forbidden', 403),
+    ]);
+
+    $platform = redditPlatform([['name' => 'pics', 'title' => 'My photo', 'type' => 'image']]);
+
+    expect(fn () => app(RedditPublisher::class)->publish($platform))
+        ->toThrow(RedditPublishException::class, 'Failed to upload the image to Reddit.');
+});
+
 test('uploads an image then submits the asset url', function () {
     test()->post->update([
         'media' => [[
diff --git a/tests/Feature/UpdatePostRequestTest.php b/tests/Feature/UpdatePostRequestTest.php
index 0a3ce111..99c300b1 100644
--- a/tests/Feature/UpdatePostRequestTest.php
+++ b/tests/Feature/UpdatePostRequestTest.php
@@ -585,3 +585,64 @@
         ])
         ->assertSessionDoesntHaveErrors('platforms.0.meta.channel_id');
 });
+
+test('publishing a reddit post with empty subreddits is rejected', function () {
+    $account = SocialAccount::factory()->reddit()->create(['workspace_id' => $this->workspace->id]);
+    $postPlatform = PostPlatform::factory()->reddit()->create([
+        'post_id' => $this->post->id,
+        'social_account_id' => $account->id,
+        'meta' => ['subreddits' => []],
+    ]);
+
+    $this->actingAs($this->user)
+        ->put(route('app.posts.update', $this->post), [
+            'status' => Status::Publishing->value,
+            'platforms' => [[
+                'id' => $postPlatform->id,
+                'content_type' => ContentType::RedditPost->value,
+                'meta' => ['subreddits' => []],
+            ]],
+        ])
+        ->assertSessionHasErrors('platforms.0.meta.subreddits');
+});
+
+test('scheduling a reddit post with empty subreddits is rejected', function () {
+    $account = SocialAccount::factory()->reddit()->create(['workspace_id' => $this->workspace->id]);
+    $postPlatform = PostPlatform::factory()->reddit()->create([
+        'post_id' => $this->post->id,
+        'social_account_id' => $account->id,
+        'meta' => ['subreddits' => []],
+    ]);
+
+    $this->actingAs($this->user)
+        ->put(route('app.posts.update', $this->post), [
+            'status' => Status::Scheduled->value,
+            'scheduled_at' => now()->addDay()->toIso8601String(),
+            'platforms' => [[
+                'id' => $postPlatform->id,
+                'content_type' => ContentType::RedditPost->value,
+                'meta' => ['subreddits' => []],
+            ]],
+        ])
+        ->assertSessionHasErrors('platforms.0.meta.subreddits');
+});
+
+test('saving a reddit post as draft without subreddits is allowed', function () {
+    $account = SocialAccount::factory()->reddit()->create(['workspace_id' => $this->workspace->id]);
+    $postPlatform = PostPlatform::factory()->reddit()->create([
+        'post_id' => $this->post->id,
+        'social_account_id' => $account->id,
+        'meta' => ['subreddits' => []],
+    ]);
+
+    $this->actingAs($this->user)
+        ->put(route('app.posts.update', $this->post), [
+            'status' => Status::Draft->value,
+            'platforms' => [[
+                'id' => $postPlatform->id,
+                'content_type' => ContentType::RedditPost->value,
+                'meta' => ['subreddits' => []],
+            ]],
+        ])
+        ->assertSessionDoesntHaveErrors('platforms.0.meta.subreddits');
+});
diff --git a/tests/Unit/Enums/ContentTypeTest.php b/tests/Unit/Enums/ContentTypeTest.php
index 38c53af4..2d593e4b 100644
--- a/tests/Unit/Enums/ContentTypeTest.php
+++ b/tests/Unit/Enums/ContentTypeTest.php
@@ -149,3 +149,18 @@
     expect(ContentType::RedditPost->value)->toBe('reddit_post')
         ->and(ContentType::RedditPost->platform())->toBe(Platform::Reddit);
 });
+
+test('reddit post supports image but not video', function () {
+    expect(ContentType::RedditPost->supportsImage())->toBeTrue()
+        ->and(ContentType::RedditPost->supportsVideo())->toBeFalse();
+});
+
+test('default content type for Reddit is RedditPost', function () {
+    expect(ContentType::defaultFor(Platform::Reddit))->toBe(ContentType::RedditPost);
+});
+
+test('forPlatform Reddit contains RedditPost', function () {
+    $types = ContentType::forPlatform(Platform::Reddit);
+
+    expect($types)->toContain(ContentType::RedditPost);
+});
diff --git a/tests/Unit/Rules/ContentTypeCompatibleWithMediaTest.php b/tests/Unit/Rules/ContentTypeCompatibleWithMediaTest.php
index 81fd06a0..f12e0faf 100644
--- a/tests/Unit/Rules/ContentTypeCompatibleWithMediaTest.php
+++ b/tests/Unit/Rules/ContentTypeCompatibleWithMediaTest.php
@@ -97,3 +97,16 @@ function runMediaRule(string $contentType, array $media): array
 test('does nothing for invalid content type values', function () {
     expect(runMediaRule('not_a_real_content_type', []))->toBe([]);
 });
+
+test('reddit text post with no media passes the rule', function () {
+    expect(runMediaRule(ContentType::RedditPost->value, []))->toBe([]);
+});
+
+test('reddit post with a video is rejected', function () {
+    $media = [['type' => MediaType::Video->value, 'mime_type' => 'video/mp4']];
+
+    $errors = runMediaRule(ContentType::RedditPost->value, $media);
+
+    expect($errors)->toHaveCount(1)
+        ->and($errors[0])->toContain('does not support videos');
+});
diff --git a/tests/Unit/Socialite/RedditProviderTest.php b/tests/Unit/Socialite/RedditProviderTest.php
index 1219b31f..49c30727 100644
--- a/tests/Unit/Socialite/RedditProviderTest.php
+++ b/tests/Unit/Socialite/RedditProviderTest.php
@@ -4,12 +4,12 @@
 
 use App\Socialite\RedditProvider;
 use Illuminate\Http\Request;
+use Laravel\Socialite\Two\User as SocialiteUser;
 
 test('reddit auth url requests a permanent token with the configured scopes', function () {
     config([
         'trypost.platforms.reddit.oauth_api' => 'https://www.reddit.com/api/v1',
         'services.reddit.client_id' => 'cid',
-        'services.reddit.redirect' => 'https://trypost.test/accounts/reddit/callback',
     ]);
 
     $request = Request::create('/connect/reddit', 'GET');
@@ -23,3 +23,47 @@
         ->toContain('client_id=cid')
         ->toContain('scope=identity');
 });
+
+function makeProvider(): RedditProvider
+{
+    config([
+        'trypost.platforms.reddit.oauth_api' => 'https://www.reddit.com/api/v1',
+        'services.reddit.client_id' => 'cid',
+    ]);
+
+    $request = Request::create('/connect/reddit', 'GET');
+    $request->setLaravelSession(app('session.store'));
+
+    return new RedditProvider($request, 'cid', 'secret', 'https://trypost.test/accounts/reddit/callback');
+}
+
+function callMapUserToObject(RedditProvider $provider, array $data): SocialiteUser
+{
+    $ref = new ReflectionMethod($provider, 'mapUserToObject');
+
+    return $ref->invoke($provider, $data);
+}
+
+test('mapUserToObject strips the query string from icon_img', function () {
+    $user = callMapUserToObject(makeProvider(), [
+        'id' => 'abc',
+        'name' => 'spez',
+        'icon_img' => 'https://i.redd.it/x.png?width=256&s=sig',
+    ]);
+
+    expect($user)->toBeInstanceOf(SocialiteUser::class)
+        ->and($user->getId())->toBe('abc')
+        ->and($user->getNickname())->toBe('spez')
+        ->and($user->getName())->toBe('spez')
+        ->and($user->getAvatar())->toBe('https://i.redd.it/x.png');
+});
+
+test('mapUserToObject returns null avatar when icon_img is blank', function () {
+    $user = callMapUserToObject(makeProvider(), [
+        'id' => 'xyz',
+        'name' => 'noavatar',
+        'icon_img' => '',
+    ]);
+
+    expect($user->getAvatar())->toBeNull();
+});

From 51033a6040c086c86d238d42da6822b5c1f67b51 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Wed, 17 Jun 2026 14:05:05 -0300
Subject: [PATCH 27/34] fix(reddit): make idFor pure, cancel debounce timer on
 row removal

---
 .../js/components/posts/editor/RedditSettings.vue     | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)

diff --git a/resources/js/components/posts/editor/RedditSettings.vue b/resources/js/components/posts/editor/RedditSettings.vue
index 0c984b8f..762e5e6e 100644
--- a/resources/js/components/posts/editor/RedditSettings.vue
+++ b/resources/js/components/posts/editor/RedditSettings.vue
@@ -88,19 +88,16 @@ watch(
             rowIds.value.push(nextId());
         }
     },
+    { immediate: true },
 );
 
-const idFor = (index: number): string => {
-    if (!rowIds.value[index]) {
-        rowIds.value[index] = nextId();
-    }
-    return rowIds.value[index];
-};
+const idFor = (index: number): string => rowIds.value[index] ?? '';
 
 const removeRow = (index: number) => {
     const removedId = rowIds.value[index];
     rowIds.value = rowIds.value.filter((_, i) => i !== index);
-    // Drop the removed row's state from all per-row dicts.
+    clearTimeout(searchTimers[removedId]);
+    delete searchTimers[removedId];
     delete rowFlairs.value[removedId];
     delete searchQueries.value[removedId];
     delete searchResults.value[removedId];

From 61eec5185b014417cffd90ba71839ee0e6a74512 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Wed, 17 Jun 2026 14:09:22 -0300
Subject: [PATCH 28/34] test(reddit): make required-on-publish API tests
 branch-specific, isolate verify-403, config hosts

---
 tests/Feature/Api/PostApiPlatformMetaTest.php | 27 +++++++++++++----
 .../Social/ConnectionVerifierRedditTest.php   |  2 ++
 .../Services/Social/RedditClientTest.php      | 30 +++++++++----------
 .../Services/Social/RedditPublisherTest.php   | 28 ++++++++---------
 4 files changed, 52 insertions(+), 35 deletions(-)

diff --git a/tests/Feature/Api/PostApiPlatformMetaTest.php b/tests/Feature/Api/PostApiPlatformMetaTest.php
index 4cc8c426..b343f73f 100644
--- a/tests/Feature/Api/PostApiPlatformMetaTest.php
+++ b/tests/Feature/Api/PostApiPlatformMetaTest.php
@@ -209,10 +209,15 @@
     $this->withHeaders($this->headers)
         ->putJson(route('api.posts.update', $post), [
             'status' => PostStatus::Publishing->value,
-            'platforms' => [['id' => $platform->id]],
+            'platforms' => [[
+                'id' => $platform->id,
+                'meta' => ['subreddits' => [['name' => 'AskReddit', 'title' => '', 'type' => 'self']]],
+            ]],
         ])
         ->assertUnprocessable()
-        ->assertJsonValidationErrors(['platforms.0.meta.subreddits']);
+        ->assertJsonValidationErrors([
+            'platforms.0.meta.subreddits' => __('posts.form.reddit.title_required'),
+        ]);
 });
 
 it('rejects publishing a Reddit link post with no url', function () {
@@ -228,10 +233,15 @@
     $this->withHeaders($this->headers)
         ->putJson(route('api.posts.update', $post), [
             'status' => PostStatus::Publishing->value,
-            'platforms' => [['id' => $platform->id]],
+            'platforms' => [[
+                'id' => $platform->id,
+                'meta' => ['subreddits' => [['name' => 'AskReddit', 'title' => 'My Link', 'type' => 'link']]],
+            ]],
         ])
         ->assertUnprocessable()
-        ->assertJsonValidationErrors(['platforms.0.meta.subreddits']);
+        ->assertJsonValidationErrors([
+            'platforms.0.meta.subreddits' => __('posts.form.reddit.url_required'),
+        ]);
 });
 
 it('rejects publishing a Reddit post where flair is required but missing', function () {
@@ -247,8 +257,13 @@
     $this->withHeaders($this->headers)
         ->putJson(route('api.posts.update', $post), [
             'status' => PostStatus::Publishing->value,
-            'platforms' => [['id' => $platform->id]],
+            'platforms' => [[
+                'id' => $platform->id,
+                'meta' => ['subreddits' => [['name' => 'AskReddit', 'title' => 'My Post', 'type' => 'self', 'flair_required' => true]]],
+            ]],
         ])
         ->assertUnprocessable()
-        ->assertJsonValidationErrors(['platforms.0.meta.subreddits']);
+        ->assertJsonValidationErrors([
+            'platforms.0.meta.subreddits' => __('posts.form.reddit.flair_required'),
+        ]);
 });
diff --git a/tests/Feature/Services/Social/ConnectionVerifierRedditTest.php b/tests/Feature/Services/Social/ConnectionVerifierRedditTest.php
index 5b7f230c..9a6a92a0 100644
--- a/tests/Feature/Services/Social/ConnectionVerifierRedditTest.php
+++ b/tests/Feature/Services/Social/ConnectionVerifierRedditTest.php
@@ -29,6 +29,7 @@
 
     $account = SocialAccount::factory()->reddit()->create([
         'token_expires_at' => now()->addDays(30),
+        'refresh_token' => null,
     ]);
 
     expect(fn () => (new ConnectionVerifier)->verify($account))
@@ -42,6 +43,7 @@
 
     $account = SocialAccount::factory()->reddit()->create([
         'token_expires_at' => now()->addDays(30),
+        'refresh_token' => null,
     ]);
 
     expect(fn () => (new ConnectionVerifier)->verify($account))
diff --git a/tests/Feature/Services/Social/RedditClientTest.php b/tests/Feature/Services/Social/RedditClientTest.php
index 6646cadc..09d143c3 100644
--- a/tests/Feature/Services/Social/RedditClientTest.php
+++ b/tests/Feature/Services/Social/RedditClientTest.php
@@ -21,7 +21,7 @@
 
 test('searchSubreddits returns names from the reddit search endpoint', function () {
     Http::fake([
-        'https://oauth.reddit.com/subreddits/search*' => Http::response([
+        config('trypost.platforms.reddit.api').'/subreddits/search*' => Http::response([
             'data' => ['children' => [
                 ['data' => ['display_name' => 'AskReddit', 'title' => 'Ask Reddit', 'subscribers' => 100, 'over18' => false, 'subreddit_type' => 'public']],
                 ['data' => ['display_name' => 'pics', 'title' => 'Pics', 'subscribers' => 50, 'over18' => false, 'subreddit_type' => 'public']],
@@ -37,13 +37,13 @@
 
 test('restrictions reports submission type, image allowance and required flair', function () {
     Http::fake([
-        'https://oauth.reddit.com/r/AskReddit/about*' => Http::response([
+        config('trypost.platforms.reddit.api').'/r/AskReddit/about*' => Http::response([
             'data' => ['submission_type' => 'self', 'allow_images' => false],
         ], 200),
-        'https://oauth.reddit.com/api/v1/AskReddit/post_requirements*' => Http::response([
+        config('trypost.platforms.reddit.api').'/api/v1/AskReddit/post_requirements*' => Http::response([
             'is_flair_required' => true,
         ], 200),
-        'https://oauth.reddit.com/r/AskReddit/api/link_flair_v2*' => Http::response([
+        config('trypost.platforms.reddit.api').'/r/AskReddit/api/link_flair_v2*' => Http::response([
             ['id' => 'abc', 'text' => 'Discussion'],
         ], 200),
     ]);
@@ -57,9 +57,9 @@
 
 test('restrictions adds image (not video or gallery) when images are allowed', function () {
     Http::fake([
-        'https://oauth.reddit.com/r/pics/about*' => Http::response(['data' => ['submission_type' => 'any', 'allow_images' => true]], 200),
-        'https://oauth.reddit.com/api/v1/pics/post_requirements*' => Http::response(['is_flair_required' => false], 200),
-        'https://oauth.reddit.com/r/pics/api/link_flair_v2*' => Http::response([], 200),
+        config('trypost.platforms.reddit.api').'/r/pics/about*' => Http::response(['data' => ['submission_type' => 'any', 'allow_images' => true]], 200),
+        config('trypost.platforms.reddit.api').'/api/v1/pics/post_requirements*' => Http::response(['is_flair_required' => false], 200),
+        config('trypost.platforms.reddit.api').'/r/pics/api/link_flair_v2*' => Http::response([], 200),
     ]);
 
     $r = app(RedditClient::class)->restrictions($this->account, 'pics');
@@ -70,13 +70,13 @@
 
 test('restrictions returns only link type when submission_type is link and images not allowed', function () {
     Http::fake([
-        'https://oauth.reddit.com/r/AnnounceOnly/about*' => Http::response([
+        config('trypost.platforms.reddit.api').'/r/AnnounceOnly/about*' => Http::response([
             'data' => ['submission_type' => 'link', 'allow_images' => false],
         ], 200),
-        'https://oauth.reddit.com/api/v1/AnnounceOnly/post_requirements*' => Http::response([
+        config('trypost.platforms.reddit.api').'/api/v1/AnnounceOnly/post_requirements*' => Http::response([
             'is_flair_required' => false,
         ], 200),
-        'https://oauth.reddit.com/r/AnnounceOnly/api/link_flair_v2*' => Http::response([], 200),
+        config('trypost.platforms.reddit.api').'/r/AnnounceOnly/api/link_flair_v2*' => Http::response([], 200),
     ]);
 
     $r = app(RedditClient::class)->restrictions($this->account, 'AnnounceOnly');
@@ -88,7 +88,7 @@
 
 test('flairs returns empty array when the flair endpoint throws a connection exception', function () {
     Http::fake([
-        'https://oauth.reddit.com/r/AskReddit/api/link_flair_v2*' => fn () => throw new ConnectionException('Connection refused'),
+        config('trypost.platforms.reddit.api').'/r/AskReddit/api/link_flair_v2*' => fn () => throw new ConnectionException('Connection refused'),
     ]);
 
     $flairs = app(RedditClient::class)->flairs($this->account, 'AskReddit');
@@ -98,13 +98,13 @@
 
 test('restrictions returns empty flairs array when the flair endpoint throws a connection exception', function () {
     Http::fake([
-        'https://oauth.reddit.com/r/AskReddit/about*' => Http::response([
+        config('trypost.platforms.reddit.api').'/r/AskReddit/about*' => Http::response([
             'data' => ['submission_type' => 'any', 'allow_images' => false],
         ], 200),
-        'https://oauth.reddit.com/api/v1/AskReddit/post_requirements*' => Http::response([
+        config('trypost.platforms.reddit.api').'/api/v1/AskReddit/post_requirements*' => Http::response([
             'is_flair_required' => true,
         ], 200),
-        'https://oauth.reddit.com/r/AskReddit/api/link_flair_v2*' => fn () => throw new ConnectionException('Connection refused'),
+        config('trypost.platforms.reddit.api').'/r/AskReddit/api/link_flair_v2*' => fn () => throw new ConnectionException('Connection refused'),
     ]);
 
     $r = app(RedditClient::class)->restrictions($this->account, 'AskReddit');
@@ -114,7 +114,7 @@
 
 test('info sums nothing for empty fullnames and maps children otherwise', function () {
     Http::fake([
-        'https://oauth.reddit.com/api/info*' => Http::response([
+        config('trypost.platforms.reddit.api').'/api/info*' => Http::response([
             'data' => ['children' => [
                 ['data' => ['name' => 't3_abc', 'score' => 12, 'num_comments' => 4, 'url' => 'https://www.reddit.com/r/x/comments/abc/y/']],
             ]],
diff --git a/tests/Feature/Services/Social/RedditPublisherTest.php b/tests/Feature/Services/Social/RedditPublisherTest.php
index a7a04b47..1989eb59 100644
--- a/tests/Feature/Services/Social/RedditPublisherTest.php
+++ b/tests/Feature/Services/Social/RedditPublisherTest.php
@@ -46,8 +46,8 @@ function redditPlatform(array $subreddits): PostPlatform
 
 test('publishes a self post and resolves the url via info', function () {
     Http::fake([
-        'https://oauth.reddit.com/api/submit*' => Http::response(['json' => ['errors' => [], 'data' => ['name' => 't3_abc', 'id' => 'abc']]], 200),
-        'https://oauth.reddit.com/api/info*' => Http::response(['data' => ['children' => [
+        config('trypost.platforms.reddit.api').'/api/submit*' => Http::response(['json' => ['errors' => [], 'data' => ['name' => 't3_abc', 'id' => 'abc']]], 200),
+        config('trypost.platforms.reddit.api').'/api/info*' => Http::response(['data' => ['children' => [
             ['data' => ['name' => 't3_abc', 'url' => 'https://www.reddit.com/r/test/comments/abc/x/']],
         ]]], 200),
     ]);
@@ -61,8 +61,8 @@ function redditPlatform(array $subreddits): PostPlatform
 
 test('submits a link post with the url', function () {
     Http::fake([
-        'https://oauth.reddit.com/api/submit*' => Http::response(['json' => ['errors' => [], 'data' => ['name' => 't3_l', 'id' => 'l']]], 200),
-        'https://oauth.reddit.com/api/info*' => Http::response(['data' => ['children' => []]], 200),
+        config('trypost.platforms.reddit.api').'/api/submit*' => Http::response(['json' => ['errors' => [], 'data' => ['name' => 't3_l', 'id' => 'l']]], 200),
+        config('trypost.platforms.reddit.api').'/api/info*' => Http::response(['data' => ['children' => []]], 200),
     ]);
 
     $platform = redditPlatform([['name' => 'test', 'title' => 'T', 'type' => 'link', 'url' => 'https://example.com']]);
@@ -73,10 +73,10 @@ function redditPlatform(array $subreddits): PostPlatform
 
 test('submits to multiple subreddits and aggregates ids', function () {
     Http::fake([
-        'https://oauth.reddit.com/api/submit*' => Http::sequence()
+        config('trypost.platforms.reddit.api').'/api/submit*' => Http::sequence()
             ->push(['json' => ['errors' => [], 'data' => ['name' => 't3_one', 'id' => 'one']]])
             ->push(['json' => ['errors' => [], 'data' => ['name' => 't3_two', 'id' => 'two']]]),
-        'https://oauth.reddit.com/api/info*' => Http::response(['data' => ['children' => []]], 200),
+        config('trypost.platforms.reddit.api').'/api/info*' => Http::response(['data' => ['children' => []]], 200),
     ]);
 
     $platform = redditPlatform([
@@ -90,10 +90,10 @@ function redditPlatform(array $subreddits): PostPlatform
 
 test('records partial failure when a later subreddit fails', function () {
     Http::fake([
-        'https://oauth.reddit.com/api/submit*' => Http::sequence()
+        config('trypost.platforms.reddit.api').'/api/submit*' => Http::sequence()
             ->push(['json' => ['errors' => [], 'data' => ['name' => 't3_one', 'id' => 'one']]])
             ->push(['json' => ['errors' => [['SUBREDDIT_NOEXIST', 'that subreddit does not exist', 'sr']]]], 200),
-        'https://oauth.reddit.com/api/info*' => Http::response(['data' => ['children' => []]], 200),
+        config('trypost.platforms.reddit.api').'/api/info*' => Http::response(['data' => ['children' => []]], 200),
     ]);
 
     $platform = redditPlatform([
@@ -112,8 +112,8 @@ function redditPlatform(array $subreddits): PostPlatform
 
 test('sends nsfw, spoiler and flair fields in the payload', function () {
     Http::fake([
-        'https://oauth.reddit.com/api/submit*' => Http::response(['json' => ['errors' => [], 'data' => ['name' => 't3_abc', 'id' => 'abc']]], 200),
-        'https://oauth.reddit.com/api/info*' => Http::response(['data' => ['children' => []]], 200),
+        config('trypost.platforms.reddit.api').'/api/submit*' => Http::response(['json' => ['errors' => [], 'data' => ['name' => 't3_abc', 'id' => 'abc']]], 200),
+        config('trypost.platforms.reddit.api').'/api/info*' => Http::response(['data' => ['children' => []]], 200),
     ]);
 
     $platform = redditPlatform([[
@@ -165,7 +165,7 @@ function redditPlatform(array $subreddits): PostPlatform
     ]);
 
     Http::fake([
-        'https://oauth.reddit.com/api/media/asset*' => Http::response([
+        config('trypost.platforms.reddit.api').'/api/media/asset*' => Http::response([
             'args' => [
                 'action' => '//reddit-uploads.s3.amazonaws.com',
                 'fields' => [['name' => 'key', 'value' => 'abc/photo.jpg']],
@@ -194,7 +194,7 @@ function redditPlatform(array $subreddits): PostPlatform
     ]);
 
     Http::fake([
-        'https://oauth.reddit.com/api/media/asset*' => Http::response([
+        config('trypost.platforms.reddit.api').'/api/media/asset*' => Http::response([
             'args' => [
                 'action' => '//reddit-uploads.s3.amazonaws.com',
                 'fields' => [['name' => 'key', 'value' => 'abc/photo.jpg'], ['name' => 'policy', 'value' => 'p']],
@@ -203,8 +203,8 @@ function redditPlatform(array $subreddits): PostPlatform
         ], 200),
         'https://reddit-uploads.s3.amazonaws.com' => Http::response('<?xml version="1.0"?><PostResponse><Location>https://reddit-uploads.s3.amazonaws.com/abc/photo.jpg</Location></PostResponse>', 201),
         'https://cdn.test/photo.jpg' => Http::response('binarybytes', 200),
-        'https://oauth.reddit.com/api/submit*' => Http::response(['json' => ['errors' => [], 'data' => ['name' => 't3_img', 'id' => 'img']]], 200),
-        'https://oauth.reddit.com/api/info*' => Http::response(['data' => ['children' => []]], 200),
+        config('trypost.platforms.reddit.api').'/api/submit*' => Http::response(['json' => ['errors' => [], 'data' => ['name' => 't3_img', 'id' => 'img']]], 200),
+        config('trypost.platforms.reddit.api').'/api/info*' => Http::response(['data' => ['children' => []]], 200),
     ]);
 
     $platform = redditPlatform([['name' => 'pics', 'title' => 'My photo', 'type' => 'image']]);

From 94bb2f21437bfe34220e88f3fad332cf89dc5125 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Wed, 17 Jun 2026 14:45:43 -0300
Subject: [PATCH 29/34] feat(reddit): gallery posts up to 10 images; sharper
 API error messages

---
 .../Social/RedditPublishException.php         |  29 +++--
 .../Social/Reddit/RedditPublisher.php         | 107 ++++++++++++++----
 .../Services/Social/RedditPublisherTest.php   |  91 ++++++++++++++-
 .../Social/RedditPublishExceptionTest.php     |  34 ++++++
 4 files changed, 227 insertions(+), 34 deletions(-)

diff --git a/app/Exceptions/Social/RedditPublishException.php b/app/Exceptions/Social/RedditPublishException.php
index 72952c10..a2eb223f 100644
--- a/app/Exceptions/Social/RedditPublishException.php
+++ b/app/Exceptions/Social/RedditPublishException.php
@@ -32,11 +32,6 @@ public static function fromApiResponse(mixed $response): static
         $rawResponse = $response->body();
         $json = $response->json() ?? [];
 
-        $errors = data_get($json, 'errors', []);
-        $apiMessage = is_array($errors) && count($errors) > 0
-            ? (string) data_get($errors, '0.1', '')
-            : '';
-
         if ($status === 401 || $status === 403) {
             return new static(
                 userMessage: 'Reddit rejected the request. Check that the account is connected and has permission to post.',
@@ -64,9 +59,7 @@ public static function fromApiResponse(mixed $response): static
             );
         }
 
-        $message = $apiMessage !== ''
-            ? $apiMessage
-            : "An unknown Reddit error occurred (HTTP {$status}).";
+        $message = self::extractApiMessage($json, $status);
 
         return new static(
             userMessage: $message,
@@ -76,6 +69,26 @@ public static function fromApiResponse(mixed $response): static
         );
     }
 
+    /**
+     * @param  array<string, mixed>  $json
+     */
+    private static function extractApiMessage(array $json, int $status): string
+    {
+        foreach ([
+            data_get($json, 'json.errors.0.1'),
+            data_get($json, 'errors.0.1'),
+            data_get($json, 'explanation'),
+            data_get($json, 'reason'),
+            data_get($json, 'message'),
+        ] as $candidate) {
+            if (is_string($candidate) && $candidate !== '') {
+                return $candidate;
+            }
+        }
+
+        return "An unknown Reddit error occurred (HTTP {$status}).";
+    }
+
     public function platform(): string
     {
         return 'reddit';
diff --git a/app/Services/Social/Reddit/RedditPublisher.php b/app/Services/Social/Reddit/RedditPublisher.php
index b6d3e25f..9fa3c79f 100644
--- a/app/Services/Social/Reddit/RedditPublisher.php
+++ b/app/Services/Social/Reddit/RedditPublisher.php
@@ -13,6 +13,7 @@
 use App\Services\Social\ContentSanitizer;
 use Illuminate\Http\Client\PendingRequest;
 use Illuminate\Http\Client\Response;
+use Illuminate\Support\Collection;
 use Illuminate\Support\Facades\Http;
 use Throwable;
 
@@ -29,8 +30,6 @@ class RedditPublisher
 
     private const SUBMIT_DELAY_MICROSECONDS = 1_100_000;
 
-    private ?MediaItem $currentMedia = null;
-
     public function __construct(private readonly RedditClient $client) {}
 
     /**
@@ -55,7 +54,10 @@ public function publish(PostPlatform $postPlatform): array
             ? app(ContentSanitizer::class)->sanitize($postPlatform->post->content, $postPlatform->platform)
             : '';
 
-        $this->currentMedia = $postPlatform->post->mediaItems->first();
+        $imageMedia = $postPlatform->post->mediaItems
+            ->filter(fn (MediaItem $item) => $item->isImage())
+            ->take($postPlatform->platform->maxImages())
+            ->values();
 
         /** @var list<array{subreddit: string, id: string, url: string}> $results */
         $results = [];
@@ -66,7 +68,7 @@ public function publish(PostPlatform $postPlatform): array
             }
 
             try {
-                $results[] = $this->submitOne($account, $sub, $text);
+                $results[] = $this->submitOne($account, $sub, $text, $imageMedia);
             } catch (Throwable $e) {
                 $this->persistResults($postPlatform, $results);
 
@@ -88,9 +90,10 @@ public function publish(PostPlatform $postPlatform): array
 
     /**
      * @param  array<string, mixed>  $sub
+     * @param  Collection<int, MediaItem>  $imageMedia
      * @return array{subreddit: string, id: string, url: string}
      */
-    private function submitOne(SocialAccount $account, array $sub, string $text): array
+    private function submitOne(SocialAccount $account, array $sub, string $text, Collection $imageMedia): array
     {
         $name = (string) data_get($sub, 'name');
         $type = (string) data_get($sub, 'type', 'self');
@@ -103,6 +106,10 @@ private function submitOne(SocialAccount $account, array $sub, string $text): ar
             );
         }
 
+        if ($type === 'image' && $imageMedia->count() >= 2) {
+            return $this->submitGallery($account, $sub, $name, $title, $imageMedia);
+        }
+
         $payload = array_filter([
             'api_type' => 'json',
             'sr' => $name,
@@ -119,7 +126,7 @@ private function submitOne(SocialAccount $account, array $sub, string $text): ar
         } elseif ($type === 'link') {
             $payload['url'] = (string) data_get($sub, 'url');
         } else {
-            $payload['url'] = $this->uploadMedia($account, $sub);
+            $payload['url'] = $this->uploadSingleImage($account, $imageMedia);
         }
 
         $response = $this->reddit($account)->asForm()->post($this->url('/api/submit'), $payload);
@@ -138,27 +145,84 @@ private function submitOne(SocialAccount $account, array $sub, string $text): ar
     }
 
     /**
-     * Uploads the post's first image through Reddit's asset lease and returns the
-     * hosted URL to submit as a link/image post.
-     *
      * @param  array<string, mixed>  $sub
+     * @param  Collection<int, MediaItem>  $imageMedia
+     * @return array{subreddit: string, id: string, url: string}
      */
-    private function uploadMedia(SocialAccount $account, array $sub): string
+    private function submitGallery(SocialAccount $account, array $sub, string $name, string $title, Collection $imageMedia): array
     {
-        $type = (string) data_get($sub, 'type');
+        $imageMedia->each(function (MediaItem $item) {
+            if ($item->isVideo()) {
+                throw new RedditPublishException(
+                    userMessage: 'Reddit video posts are not supported yet.',
+                    category: ErrorCategory::MediaFormat,
+                );
+            }
+        });
+
+        $items = $imageMedia->map(function (MediaItem $item) use ($account) {
+            ['asset_id' => $assetId] = $this->leaseAndUpload($account, $item);
+
+            return ['media_id' => $assetId, 'caption' => '', 'outbound_url' => ''];
+        })->values()->all();
+
+        $payload = array_filter([
+            'api_type' => 'json',
+            'sr' => $name,
+            'title' => $title,
+            'nsfw' => (bool) data_get($sub, 'nsfw', false) ? 'true' : null,
+            'spoiler' => (bool) data_get($sub, 'spoiler', false) ? 'true' : null,
+            'flair_id' => data_get($sub, 'flair_id') ?: null,
+            'flair_text' => data_get($sub, 'flair_text') ?: null,
+            'items' => json_encode($items),
+        ], fn ($v) => $v !== null);
+
+        $response = $this->reddit($account)->asForm()->post($this->url('/api/submit_gallery_post.json'), $payload);
+
+        $this->assertOk($response);
 
-        if ($type !== 'image') {
+        $id = (string) data_get($response->json(), 'json.data.id');
+        $fullname = (string) data_get($response->json(), 'json.data.name');
+        $fullname = $fullname !== '' ? $fullname : ($id !== '' ? "t3_{$id}" : '');
+
+        return [
+            'subreddit' => $name,
+            'id' => $fullname,
+            'url' => $this->resolveUrl($account, $fullname),
+        ];
+    }
+
+    /**
+     * @param  Collection<int, MediaItem>  $imageMedia
+     */
+    private function uploadSingleImage(SocialAccount $account, Collection $imageMedia): string
+    {
+        $item = $imageMedia->first() ?? throw new RedditPublishException(
+            userMessage: 'No image attached for this Reddit image post.',
+            category: ErrorCategory::MediaFormat,
+        );
+
+        if ($item->isVideo()) {
             throw new RedditPublishException(
-                userMessage: 'Reddit video and gallery posts are not supported yet.',
+                userMessage: 'Reddit video posts are not supported yet.',
                 category: ErrorCategory::MediaFormat,
             );
         }
 
-        $item = $this->currentMedia ?? throw new RedditPublishException(
-            userMessage: 'No image attached for this Reddit image post.',
-            category: ErrorCategory::MediaFormat,
-        );
+        ['url' => $hostedUrl] = $this->leaseAndUpload($account, $item);
 
+        return $hostedUrl;
+    }
+
+    /**
+     * Leases a Reddit media asset, uploads the file to S3, and returns both
+     * the asset_id (needed for gallery submissions) and the hosted URL
+     * (needed for single-image submissions).
+     *
+     * @return array{asset_id: string, url: string}
+     */
+    private function leaseAndUpload(SocialAccount $account, MediaItem $item): array
+    {
         $mime = (string) ($item->mime_type ?: 'image/jpeg');
         $filename = $item->original_filename ?: (basename((string) $item->path) ?: 'image');
 
@@ -168,6 +232,7 @@ private function uploadMedia(SocialAccount $account, array $sub): string
         ]);
         $this->assertOk($lease);
 
+        $assetId = (string) data_get($lease->json(), 'asset.asset_id');
         $action = 'https:'.preg_replace('#^https?:#', '', (string) data_get($lease->json(), 'args.action'));
         $fields = collect((array) data_get($lease->json(), 'args.fields'))
             ->mapWithKeys(fn ($f) => [(string) data_get($f, 'name') => (string) data_get($f, 'value')])
@@ -176,8 +241,8 @@ private function uploadMedia(SocialAccount $account, array $sub): string
         $bytes = Http::timeout(120)->get($item->url)->body();
 
         $upload = Http::asMultipart();
-        foreach ($fields as $name => $value) {
-            $upload = $upload->attach($name, $value);
+        foreach ($fields as $fieldName => $value) {
+            $upload = $upload->attach($fieldName, $value);
         }
         $upload = $upload->attach('file', $bytes, $filename);
         $s3 = $upload->post($action);
@@ -190,10 +255,10 @@ private function uploadMedia(SocialAccount $account, array $sub): string
         }
 
         if (preg_match('/<Location>(.*?)<\/Location>/', $s3->body(), $m)) {
-            return html_entity_decode($m[1]);
+            return ['asset_id' => $assetId, 'url' => html_entity_decode($m[1])];
         }
 
-        return rtrim($action, '/').'/'.($fields['key'] ?? $filename);
+        return ['asset_id' => $assetId, 'url' => rtrim($action, '/').'/'.($fields['key'] ?? $filename)];
     }
 
     private function resolveUrl(SocialAccount $account, string $fullname): string
diff --git a/tests/Feature/Services/Social/RedditPublisherTest.php b/tests/Feature/Services/Social/RedditPublisherTest.php
index 1989eb59..0b6f7e65 100644
--- a/tests/Feature/Services/Social/RedditPublisherTest.php
+++ b/tests/Feature/Services/Social/RedditPublisherTest.php
@@ -139,11 +139,9 @@ function redditPlatform(array $subreddits): PostPlatform
     expect(fn () => app(RedditPublisher::class)->publish($platform))->toThrow(RedditPublishException::class);
 });
 
-test('throws for video and gallery since they are not yet supported', function () {
-    foreach (['video', 'gallery'] as $type) {
-        $platform = redditPlatform([['name' => 'test', 'title' => 'T', 'type' => $type]]);
-        expect(fn () => app(RedditPublisher::class)->publish($platform))->toThrow(RedditPublishException::class);
-    }
+test('throws for video type since it is not yet supported', function () {
+    $platform = redditPlatform([['name' => 'test', 'title' => 'T', 'type' => 'video']]);
+    expect(fn () => app(RedditPublisher::class)->publish($platform))->toThrow(RedditPublishException::class);
 });
 
 test('throws when an image post has no media attached', function () {
@@ -213,3 +211,86 @@ function redditPlatform(array $subreddits): PostPlatform
     expect($result['id'])->toContain('img');
     Http::assertSent(fn ($r) => str_contains($r->url(), '/api/submit') && isset($r['url']) && str_contains((string) $r['url'], 'photo.jpg'));
 });
+
+test('gallery: 3 images upload and submit via submit_gallery_post with 3 media_ids', function () {
+    test()->post->update([
+        'media' => [
+            ['id' => 'g1', 'path' => 'media/img1.jpg', 'url' => 'https://cdn.test/img1.jpg', 'mime_type' => 'image/jpeg', 'original_filename' => 'img1.jpg'],
+            ['id' => 'g2', 'path' => 'media/img2.jpg', 'url' => 'https://cdn.test/img2.jpg', 'mime_type' => 'image/jpeg', 'original_filename' => 'img2.jpg'],
+            ['id' => 'g3', 'path' => 'media/img3.jpg', 'url' => 'https://cdn.test/img3.jpg', 'mime_type' => 'image/jpeg', 'original_filename' => 'img3.jpg'],
+        ],
+    ]);
+
+    Http::fake([
+        config('trypost.platforms.reddit.api').'/api/media/asset*' => Http::sequence()
+            ->push(['args' => ['action' => '//reddit-uploads.s3.amazonaws.com', 'fields' => [['name' => 'key', 'value' => 'abc/img1.jpg']]], 'asset' => ['asset_id' => 'asset-id-1']], 200)
+            ->push(['args' => ['action' => '//reddit-uploads.s3.amazonaws.com', 'fields' => [['name' => 'key', 'value' => 'abc/img2.jpg']]], 'asset' => ['asset_id' => 'asset-id-2']], 200)
+            ->push(['args' => ['action' => '//reddit-uploads.s3.amazonaws.com', 'fields' => [['name' => 'key', 'value' => 'abc/img3.jpg']]], 'asset' => ['asset_id' => 'asset-id-3']], 200),
+        'https://reddit-uploads.s3.amazonaws.com' => Http::response('<?xml version="1.0"?><PostResponse><Location>https://reddit-uploads.s3.amazonaws.com/abc/img.jpg</Location></PostResponse>', 201),
+        'https://cdn.test/img1.jpg' => Http::response('bytes1', 200),
+        'https://cdn.test/img2.jpg' => Http::response('bytes2', 200),
+        'https://cdn.test/img3.jpg' => Http::response('bytes3', 200),
+        config('trypost.platforms.reddit.api').'/api/submit_gallery_post.json*' => Http::response(['json' => ['errors' => [], 'data' => ['name' => 't3_gal', 'id' => 'gal']]], 200),
+        config('trypost.platforms.reddit.api').'/api/info*' => Http::response(['data' => ['children' => [
+            ['data' => ['name' => 't3_gal', 'url' => 'https://www.reddit.com/r/pics/comments/gal/x/']],
+        ]]], 200),
+    ]);
+
+    $platform = redditPlatform([['name' => 'pics', 'title' => 'My gallery', 'type' => 'image']]);
+    $result = app(RedditPublisher::class)->publish($platform);
+
+    expect($result['id'])->toContain('gal');
+    Http::assertSent(function ($r) {
+        if (! str_contains($r->url(), '/api/submit_gallery_post.json')) {
+            return false;
+        }
+        $items = json_decode((string) $r['items'], true);
+
+        return is_array($items)
+            && count($items) === 3
+            && $items[0]['media_id'] === 'asset-id-1'
+            && $items[1]['media_id'] === 'asset-id-2'
+            && $items[2]['media_id'] === 'asset-id-3';
+    });
+});
+
+test('more than 10 images are capped at 10', function () {
+    $media = collect(range(1, 12))->map(fn ($i) => [
+        'id' => "g{$i}",
+        'path' => "media/img{$i}.jpg",
+        'url' => "https://cdn.test/img{$i}.jpg",
+        'mime_type' => 'image/jpeg',
+        'original_filename' => "img{$i}.jpg",
+    ])->all();
+
+    test()->post->update(['media' => $media]);
+
+    $leaseSequence = Http::sequence();
+    for ($i = 1; $i <= 10; $i++) {
+        $leaseSequence->push(['args' => ['action' => '//reddit-uploads.s3.amazonaws.com', 'fields' => [['name' => 'key', 'value' => "abc/img{$i}.jpg"]]], 'asset' => ['asset_id' => "asset-id-{$i}"]], 200);
+    }
+
+    $cdnFakes = [];
+    for ($i = 1; $i <= 12; $i++) {
+        $cdnFakes["https://cdn.test/img{$i}.jpg"] = Http::response("bytes{$i}", 200);
+    }
+
+    Http::fake(array_merge([
+        config('trypost.platforms.reddit.api').'/api/media/asset*' => $leaseSequence,
+        'https://reddit-uploads.s3.amazonaws.com' => Http::response('<?xml version="1.0"?><PostResponse><Location>https://reddit-uploads.s3.amazonaws.com/abc/img.jpg</Location></PostResponse>', 201),
+        config('trypost.platforms.reddit.api').'/api/submit_gallery_post.json*' => Http::response(['json' => ['errors' => [], 'data' => ['name' => 't3_cap', 'id' => 'cap']]], 200),
+        config('trypost.platforms.reddit.api').'/api/info*' => Http::response(['data' => ['children' => []]], 200),
+    ], $cdnFakes));
+
+    $platform = redditPlatform([['name' => 'pics', 'title' => 'Gallery cap test', 'type' => 'image']]);
+    app(RedditPublisher::class)->publish($platform);
+
+    Http::assertSent(function ($r) {
+        if (! str_contains($r->url(), '/api/submit_gallery_post.json')) {
+            return false;
+        }
+        $items = json_decode((string) $r['items'], true);
+
+        return is_array($items) && count($items) === 10;
+    });
+});
diff --git a/tests/Unit/Exceptions/Social/RedditPublishExceptionTest.php b/tests/Unit/Exceptions/Social/RedditPublishExceptionTest.php
index 52b22285..725e7b62 100644
--- a/tests/Unit/Exceptions/Social/RedditPublishExceptionTest.php
+++ b/tests/Unit/Exceptions/Social/RedditPublishExceptionTest.php
@@ -92,3 +92,37 @@
 
     expect($exception->platform())->toBe('reddit');
 });
+
+test('json.errors submit wrapper message takes priority over top-level errors', function () {
+    $response = Http::response([
+        'json' => ['errors' => [['SUBREDDIT_BANNED', 'that subreddit is banned', 'sr']]],
+        'errors' => [['OTHER', 'fallback message', 'x']],
+    ], 400);
+    $fakeResponse = Http::fake(['*' => $response])->post('https://oauth.reddit.com/api/submit');
+
+    $exception = RedditPublishException::fromApiResponse($fakeResponse);
+
+    expect($exception->userMessage)->toBe('that subreddit is banned');
+});
+
+test('explanation field is used for api errors without errors array', function () {
+    $response = Http::response([
+        'reason' => 'BAD_SR_NAME',
+        'explanation' => 'that name is taken',
+        'message' => 'Bad Request',
+    ], 400);
+    $fakeResponse = Http::fake(['*' => $response])->post('https://oauth.reddit.com/api/submit');
+
+    $exception = RedditPublishException::fromApiResponse($fakeResponse);
+
+    expect($exception->userMessage)->toBe('that name is taken');
+});
+
+test('message field is used when no errors or explanation present', function () {
+    $response = Http::response(['message' => 'Forbidden'], 404);
+    $fakeResponse = Http::fake(['*' => $response])->post('https://oauth.reddit.com/api/submit');
+
+    $exception = RedditPublishException::fromApiResponse($fakeResponse);
+
+    expect($exception->userMessage)->toBe('Forbidden');
+});

From 6a91ff8f602d30ff45fe4c45c653b2bcf812b729 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Wed, 17 Jun 2026 14:47:02 -0300
Subject: [PATCH 30/34] feat(reddit): cap images at 10 to match gallery support

---
 app/Enums/PostPlatform/ContentType.php | 2 +-
 app/Enums/SocialAccount/Platform.php   | 2 +-
 tests/Unit/Enums/PlatformTest.php      | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/app/Enums/PostPlatform/ContentType.php b/app/Enums/PostPlatform/ContentType.php
index b20a7913..1d28b531 100644
--- a/app/Enums/PostPlatform/ContentType.php
+++ b/app/Enums/PostPlatform/ContentType.php
@@ -184,7 +184,7 @@ public function maxMediaCount(): int
             self::MastodonPost => 4,
             self::TelegramPost => 10,
             self::DiscordMessage => 10,
-            self::RedditPost => 20,
+            self::RedditPost => 10,
         };
     }
 
diff --git a/app/Enums/SocialAccount/Platform.php b/app/Enums/SocialAccount/Platform.php
index 30951fda..40e523f5 100644
--- a/app/Enums/SocialAccount/Platform.php
+++ b/app/Enums/SocialAccount/Platform.php
@@ -99,7 +99,7 @@ public function maxImages(): int
             self::Mastodon => 4,
             self::Telegram => 10,
             self::Discord => 10,
-            self::Reddit => 20,
+            self::Reddit => 10,
         };
     }
 
diff --git a/tests/Unit/Enums/PlatformTest.php b/tests/Unit/Enums/PlatformTest.php
index 2a263ff5..d322f459 100644
--- a/tests/Unit/Enums/PlatformTest.php
+++ b/tests/Unit/Enums/PlatformTest.php
@@ -114,7 +114,7 @@
         ->and(Platform::Reddit->label())->toBe('Reddit')
         ->and(Platform::Reddit->color())->toBe('#FF4500')
         ->and(Platform::Reddit->allowedMediaTypes())->toBe([MediaType::Image])
-        ->and(Platform::Reddit->maxImages())->toBe(20)
+        ->and(Platform::Reddit->maxImages())->toBe(10)
         ->and(Platform::Reddit->maxContentLength())->toBe(40000)
         ->and(Platform::Reddit->recommendedAiContentLength())->toBe(500)
         ->and(Platform::Reddit->requiredPublishScopes())->toBe(['submit'])

From 098a1653df6c7e804f4352757bbf3400c36eb12b Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Wed, 17 Jun 2026 14:47:02 -0300
Subject: [PATCH 31/34] chore(reddit): document reddit env vars in docker
 example

---
 docker/.env.docker.example | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docker/.env.docker.example b/docker/.env.docker.example
index 0c31fd1a..10ffa75c 100644
--- a/docker/.env.docker.example
+++ b/docker/.env.docker.example
@@ -138,6 +138,14 @@ TELEGRAM_BOT_TOKEN=
 TELEGRAM_BOT_USERNAME=
 TELEGRAM_WEBHOOK_SECRET=
 
+# Reddit (create an app at https://www.reddit.com/prefs/apps — choose "web app")
+REDDIT_ENABLED=true
+REDDIT_CLIENT_ID=
+REDDIT_CLIENT_SECRET=
+REDDIT_CLIENT_REDIRECT="${APP_URL}/accounts/reddit/callback"
+REDDIT_USER_AGENT="web:it.trypost:1.0 (by /u/trypost)"
+REDDIT_SCOPES="identity,read,submit,flair,mysubreddits"
+
 # AI Services
 OPENAI_API_KEY=
 ANTHROPIC_API_KEY=

From a785f9baec61d57f45b0a254a871519729a7e3ba Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Wed, 17 Jun 2026 14:51:06 -0300
Subject: [PATCH 32/34] refactor(reddit): default reddit user-agent to shared
 TRYPOST_USER_AGENT

---
 .env.example               | 3 ++-
 config/trypost.php         | 6 ++++--
 docker/.env.docker.example | 3 ++-
 3 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/.env.example b/.env.example
index eaa4db94..803b2842 100644
--- a/.env.example
+++ b/.env.example
@@ -174,7 +174,8 @@ REDDIT_ENABLED=true
 REDDIT_CLIENT_ID=
 REDDIT_CLIENT_SECRET=
 REDDIT_CLIENT_REDIRECT="${APP_URL}/accounts/reddit/callback"
-REDDIT_USER_AGENT="web:it.trypost:1.0 (by /u/trypost)"
+# Optional — defaults to TRYPOST_USER_AGENT. Reddit recommends "platform:appid:version (by /u/username)".
+# REDDIT_USER_AGENT=
 REDDIT_SCOPES="identity,read,submit,flair,mysubreddits"
 
 # AI Services
diff --git a/config/trypost.php b/config/trypost.php
index b8c995f5..2387a5da 100644
--- a/config/trypost.php
+++ b/config/trypost.php
@@ -2,6 +2,8 @@
 
 declare(strict_types=1);
 
+$userAgent = env('TRYPOST_USER_AGENT', 'TryPost.it/1.0 (+https://trypost.it)');
+
 return [
 
     /*
@@ -70,7 +72,7 @@
     |
     */
 
-    'user_agent' => env('TRYPOST_USER_AGENT', 'TryPost.it/1.0 (+https://trypost.it)'),
+    'user_agent' => $userAgent,
 
     'google_auth_enabled' => env('GOOGLE_AUTH_ENABLED', false),
 
@@ -180,7 +182,7 @@
             'enabled' => env('REDDIT_ENABLED', true),
             'api' => env('REDDIT_API', 'https://oauth.reddit.com'),
             'oauth_api' => env('REDDIT_OAUTH_API', 'https://www.reddit.com/api/v1'),
-            'user_agent' => env('REDDIT_USER_AGENT', 'web:it.trypost:1.0 (by /u/trypost)'),
+            'user_agent' => env('REDDIT_USER_AGENT', $userAgent),
             'scopes' => array_values(array_filter(array_map('trim', explode(',', (string) env('REDDIT_SCOPES', 'identity,read,submit,flair,mysubreddits'))))),
         ],
     ],
diff --git a/docker/.env.docker.example b/docker/.env.docker.example
index 10ffa75c..2f227bfa 100644
--- a/docker/.env.docker.example
+++ b/docker/.env.docker.example
@@ -143,7 +143,8 @@ REDDIT_ENABLED=true
 REDDIT_CLIENT_ID=
 REDDIT_CLIENT_SECRET=
 REDDIT_CLIENT_REDIRECT="${APP_URL}/accounts/reddit/callback"
-REDDIT_USER_AGENT="web:it.trypost:1.0 (by /u/trypost)"
+# Optional — defaults to TRYPOST_USER_AGENT. Reddit recommends "platform:appid:version (by /u/username)".
+# REDDIT_USER_AGENT=
 REDDIT_SCOPES="identity,read,submit,flair,mysubreddits"
 
 # AI Services

From 2dee60693ec0a685a03c8d4d92211b5229477540 Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Wed, 17 Jun 2026 14:51:48 -0300
Subject: [PATCH 33/34] docs: require shared config user-agent for outbound
 HTTP

---
 CLAUDE.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/CLAUDE.md b/CLAUDE.md
index ce363040..e5046c42 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -336,6 +336,11 @@ Vue components must have a single root element.
     - Tests: use the same `config(...)` value in `Http::fake([...])` — `Http::fake([config('trypost.platforms.x.api').'/oauth2/token' => ...])`. Tests with hardcoded URLs drift silently when the config changes.
     - Path/route segments after the host (e.g. `/oauth/v2/accessToken`, `/xrpc/com.atproto.server.refreshSession`) are part of the provider's protocol spec — those stay inline next to the call. Only the host comes from config.
 
+## HTTP User-Agent
+
+- NEVER hardcode a custom `User-Agent` string for outbound HTTP. There is ONE shared default: `config('trypost.user_agent')` (`env('TRYPOST_USER_AGENT', ...)`). Use it for any outbound request that needs a UA.
+    - If a provider REQUIRES its own UA (e.g. Reddit's API mandates a unique descriptive User-Agent), add a per-platform key under `config/trypost.php` `platforms.<name>.user_agent` that DEFAULTS to the shared one — `env('<PLATFORM>_USER_AGENT', $userAgent)` where `$userAgent` is the hoisted shared value — never a fresh hardcoded literal.
+
 ## TryPost.it Documentation
 
 - All our documentation to final user it's under https://docs.trypost.it

From bc0d1f76a2393743535cbcc8932f3bb85c9768fb Mon Sep 17 00:00:00 2001
From: Paulo Castellano <paulo@castellanos.llc>
Date: Wed, 17 Jun 2026 14:58:50 -0300
Subject: [PATCH 34/34] refactor: centralize outbound User-Agent in
 config('app.user_agent')

---
 .env.example                                     |  2 --
 CLAUDE.md                                        |  3 +--
 .../Automation/Node/RunHttpRequestNode.php       |  2 +-
 app/Actions/Automation/Node/RunWebhookNode.php   |  2 +-
 app/Services/Social/ConnectionVerifier.php       |  4 ++--
 app/Services/Social/Reddit/RedditClient.php      |  2 +-
 app/Services/Social/Reddit/RedditPublisher.php   |  2 +-
 app/Socialite/RedditProvider.php                 |  4 ++--
 config/app.php                                   | 13 +++++++++++++
 config/trypost.php                               | 16 ----------------
 docker/.env.docker.example                       |  2 --
 .../Automation/Node/HttpRequestNodeTest.php      |  2 +-
 .../Feature/Automation/Node/WebhookNodeTest.php  |  2 +-
 tests/Feature/Reddit/RedditLookupTest.php        |  2 +-
 .../Services/Social/RedditAnalyticsTest.php      |  2 +-
 .../Feature/Services/Social/RedditClientTest.php |  4 +++-
 .../Services/Social/RedditPublisherTest.php      |  2 +-
 17 files changed, 30 insertions(+), 36 deletions(-)

diff --git a/.env.example b/.env.example
index 803b2842..eb09d377 100644
--- a/.env.example
+++ b/.env.example
@@ -174,8 +174,6 @@ REDDIT_ENABLED=true
 REDDIT_CLIENT_ID=
 REDDIT_CLIENT_SECRET=
 REDDIT_CLIENT_REDIRECT="${APP_URL}/accounts/reddit/callback"
-# Optional — defaults to TRYPOST_USER_AGENT. Reddit recommends "platform:appid:version (by /u/username)".
-# REDDIT_USER_AGENT=
 REDDIT_SCOPES="identity,read,submit,flair,mysubreddits"
 
 # AI Services
diff --git a/CLAUDE.md b/CLAUDE.md
index e5046c42..7d21a0d3 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -338,8 +338,7 @@ Vue components must have a single root element.
 
 ## HTTP User-Agent
 
-- NEVER hardcode a custom `User-Agent` string for outbound HTTP. There is ONE shared default: `config('trypost.user_agent')` (`env('TRYPOST_USER_AGENT', ...)`). Use it for any outbound request that needs a UA.
-    - If a provider REQUIRES its own UA (e.g. Reddit's API mandates a unique descriptive User-Agent), add a per-platform key under `config/trypost.php` `platforms.<name>.user_agent` that DEFAULTS to the shared one — `env('<PLATFORM>_USER_AGENT', $userAgent)` where `$userAgent` is the hoisted shared value — never a fresh hardcoded literal.
+- NEVER hardcode a `User-Agent` string for outbound HTTP, and NEVER add a per-platform or per-feature user-agent config key. There is ONE source of truth: `config('app.user_agent')` (backed by `env('TRYPOST_USER_AGENT', ...)` in `config/app.php`). Every outbound request that needs a UA — automation webhook/http nodes, social provider APIs (Reddit, etc.), anything — reads `config('app.user_agent')`.
 
 ## TryPost.it Documentation
 
diff --git a/app/Actions/Automation/Node/RunHttpRequestNode.php b/app/Actions/Automation/Node/RunHttpRequestNode.php
index 0036cdc7..6f555cb6 100644
--- a/app/Actions/Automation/Node/RunHttpRequestNode.php
+++ b/app/Actions/Automation/Node/RunHttpRequestNode.php
@@ -364,7 +364,7 @@ private function buildRequest(array $config, array $context): PendingRequest
             $request = $request->withHeaders($headers);
         }
 
-        return $request->withUserAgent(config('trypost.user_agent'));
+        return $request->withUserAgent(config('app.user_agent'));
     }
 
     /**
diff --git a/app/Actions/Automation/Node/RunWebhookNode.php b/app/Actions/Automation/Node/RunWebhookNode.php
index 0b5498c9..3d743b7b 100644
--- a/app/Actions/Automation/Node/RunWebhookNode.php
+++ b/app/Actions/Automation/Node/RunWebhookNode.php
@@ -74,7 +74,7 @@ public function __invoke(AutomationRun $run, array $config): NodeRunResult
 
         try {
             $response = Http::withHeaders($headers)
-                ->withUserAgent(config('trypost.user_agent'))
+                ->withUserAgent(config('app.user_agent'))
                 ->send($method, $url, ['json' => $payload]);
         } catch (Throwable $e) {
             return NodeRunResult::failed(__('automations.errors.webhook_request_failed'), [
diff --git a/app/Services/Social/ConnectionVerifier.php b/app/Services/Social/ConnectionVerifier.php
index fd42fa36..a329c6b8 100644
--- a/app/Services/Social/ConnectionVerifier.php
+++ b/app/Services/Social/ConnectionVerifier.php
@@ -543,7 +543,7 @@ private function verifyMastodon(SocialAccount $account): bool
     private function verifyReddit(SocialAccount $account): bool
     {
         $response = Http::withToken((string) $account->access_token)
-            ->withHeaders(['User-Agent' => (string) config('trypost.platforms.reddit.user_agent')])
+            ->withHeaders(['User-Agent' => (string) config('app.user_agent')])
             ->get(config('trypost.platforms.reddit.api').'/api/v1/me');
 
         if (in_array($response->status(), [401, 403], true)) {
@@ -561,7 +561,7 @@ private function refreshRedditToken(SocialAccount $account): void
 
         $response = TokenRefreshClient::for(Platform::Reddit)->send(fn () => Http::asForm()
             ->withBasicAuth((string) config('services.reddit.client_id'), (string) config('services.reddit.client_secret'))
-            ->withHeaders(['User-Agent' => (string) config('trypost.platforms.reddit.user_agent')])
+            ->withHeaders(['User-Agent' => (string) config('app.user_agent')])
             ->post(config('trypost.platforms.reddit.oauth_api').'/access_token', [
                 'grant_type' => 'refresh_token',
                 'refresh_token' => $account->refresh_token,
diff --git a/app/Services/Social/Reddit/RedditClient.php b/app/Services/Social/Reddit/RedditClient.php
index f4f51fee..6be3a479 100644
--- a/app/Services/Social/Reddit/RedditClient.php
+++ b/app/Services/Social/Reddit/RedditClient.php
@@ -135,6 +135,6 @@ private function reddit(SocialAccount $account): PendingRequest
     {
         return $this->socialHttp()
             ->withToken((string) $account->access_token)
-            ->withHeaders(['User-Agent' => (string) config('trypost.platforms.reddit.user_agent')]);
+            ->withHeaders(['User-Agent' => (string) config('app.user_agent')]);
     }
 }
diff --git a/app/Services/Social/Reddit/RedditPublisher.php b/app/Services/Social/Reddit/RedditPublisher.php
index 9fa3c79f..8269e637 100644
--- a/app/Services/Social/Reddit/RedditPublisher.php
+++ b/app/Services/Social/Reddit/RedditPublisher.php
@@ -312,6 +312,6 @@ private function reddit(SocialAccount $account): PendingRequest
     {
         return $this->socialHttp()
             ->withToken((string) $account->access_token)
-            ->withHeaders(['User-Agent' => (string) config('trypost.platforms.reddit.user_agent')]);
+            ->withHeaders(['User-Agent' => (string) config('app.user_agent')]);
     }
 }
diff --git a/app/Socialite/RedditProvider.php b/app/Socialite/RedditProvider.php
index 7540be0a..60fdb667 100644
--- a/app/Socialite/RedditProvider.php
+++ b/app/Socialite/RedditProvider.php
@@ -50,7 +50,7 @@ public function getAccessTokenResponse($code): array
             'auth' => [config('services.reddit.client_id'), config('services.reddit.client_secret')],
             'headers' => [
                 'Accept' => 'application/json',
-                'User-Agent' => config('trypost.platforms.reddit.user_agent'),
+                'User-Agent' => config('app.user_agent'),
             ],
             'form_params' => [
                 'grant_type' => 'authorization_code',
@@ -70,7 +70,7 @@ protected function getUserByToken($token): array
         $response = $this->getHttpClient()->get(config('trypost.platforms.reddit.api').'/api/v1/me', [
             'headers' => [
                 'Authorization' => "Bearer {$token}",
-                'User-Agent' => config('trypost.platforms.reddit.user_agent'),
+                'User-Agent' => config('app.user_agent'),
             ],
         ]);
 
diff --git a/config/app.php b/config/app.php
index e8080f34..6e1f4277 100644
--- a/config/app.php
+++ b/config/app.php
@@ -69,6 +69,19 @@
 
     'webhook_url' => env('WEBHOOK_URL', env('APP_URL', 'https://app.trypost.it')),
 
+    /*
+    |--------------------------------------------------------------------------
+    | Outbound User-Agent
+    |--------------------------------------------------------------------------
+    |
+    | Single, branded User-Agent for every outbound HTTP request the app makes
+    | (automation webhook/http nodes, social provider APIs, etc.). Centralized
+    | here so there is one source of truth; self-hosters can override it.
+    |
+    */
+
+    'user_agent' => env('TRYPOST_USER_AGENT', 'TryPost.it/1.0 (+https://trypost.it)'),
+
     /*
     |--------------------------------------------------------------------------
     | Application Timezone
diff --git a/config/trypost.php b/config/trypost.php
index 2387a5da..ff800dde 100644
--- a/config/trypost.php
+++ b/config/trypost.php
@@ -2,8 +2,6 @@
 
 declare(strict_types=1);
 
-$userAgent = env('TRYPOST_USER_AGENT', 'TryPost.it/1.0 (+https://trypost.it)');
-
 return [
 
     /*
@@ -61,19 +59,6 @@
     |
     */
 
-    /*
-    |--------------------------------------------------------------------------
-    | Outbound User-Agent
-    |--------------------------------------------------------------------------
-    |
-    | Branded User-Agent applied to outbound HTTP from automation nodes
-    | (webhook + http_request) so recipients know the request came from
-    | TryPost.it. Self-hosters can override it.
-    |
-    */
-
-    'user_agent' => $userAgent,
-
     'google_auth_enabled' => env('GOOGLE_AUTH_ENABLED', false),
 
     'github_auth_enabled' => env('GITHUB_AUTH_ENABLED', false),
@@ -182,7 +167,6 @@
             'enabled' => env('REDDIT_ENABLED', true),
             'api' => env('REDDIT_API', 'https://oauth.reddit.com'),
             'oauth_api' => env('REDDIT_OAUTH_API', 'https://www.reddit.com/api/v1'),
-            'user_agent' => env('REDDIT_USER_AGENT', $userAgent),
             'scopes' => array_values(array_filter(array_map('trim', explode(',', (string) env('REDDIT_SCOPES', 'identity,read,submit,flair,mysubreddits'))))),
         ],
     ],
diff --git a/docker/.env.docker.example b/docker/.env.docker.example
index 2f227bfa..88ff7bd7 100644
--- a/docker/.env.docker.example
+++ b/docker/.env.docker.example
@@ -143,8 +143,6 @@ REDDIT_ENABLED=true
 REDDIT_CLIENT_ID=
 REDDIT_CLIENT_SECRET=
 REDDIT_CLIENT_REDIRECT="${APP_URL}/accounts/reddit/callback"
-# Optional — defaults to TRYPOST_USER_AGENT. Reddit recommends "platform:appid:version (by /u/username)".
-# REDDIT_USER_AGENT=
 REDDIT_SCOPES="identity,read,submit,flair,mysubreddits"
 
 # AI Services
diff --git a/tests/Feature/Automation/Node/HttpRequestNodeTest.php b/tests/Feature/Automation/Node/HttpRequestNodeTest.php
index 4f5a8188..1d700ff9 100644
--- a/tests/Feature/Automation/Node/HttpRequestNodeTest.php
+++ b/tests/Feature/Automation/Node/HttpRequestNodeTest.php
@@ -277,7 +277,7 @@
         'headers' => ['User-Agent' => 'user-supplied-agent'],
     ]);
 
-    Http::assertSent(fn ($request) => $request->hasHeader('User-Agent', config('trypost.user_agent')));
+    Http::assertSent(fn ($request) => $request->hasHeader('User-Agent', config('app.user_agent')));
 });
 
 it('sends custom headers configured in the editor', function () {
diff --git a/tests/Feature/Automation/Node/WebhookNodeTest.php b/tests/Feature/Automation/Node/WebhookNodeTest.php
index 727de55b..dab4f2b0 100644
--- a/tests/Feature/Automation/Node/WebhookNodeTest.php
+++ b/tests/Feature/Automation/Node/WebhookNodeTest.php
@@ -42,7 +42,7 @@
         'payload_template' => '{}',
     ]);
 
-    Http::assertSent(fn ($request) => $request->hasHeader('User-Agent', config('trypost.user_agent')));
+    Http::assertSent(fn ($request) => $request->hasHeader('User-Agent', config('app.user_agent')));
 });
 
 it('escapes special characters in templated payload values so the JSON stays valid', function () {
diff --git a/tests/Feature/Reddit/RedditLookupTest.php b/tests/Feature/Reddit/RedditLookupTest.php
index f4f6cbf4..c93dc28f 100644
--- a/tests/Feature/Reddit/RedditLookupTest.php
+++ b/tests/Feature/Reddit/RedditLookupTest.php
@@ -11,7 +11,7 @@
 beforeEach(function () {
     config([
         'trypost.platforms.reddit.api' => 'https://oauth.reddit.com',
-        'trypost.platforms.reddit.user_agent' => 'web:it.trypost:1.0',
+        'app.user_agent' => 'web:it.trypost:1.0',
     ]);
 
     $this->user = User::factory()->create();
diff --git a/tests/Feature/Services/Social/RedditAnalyticsTest.php b/tests/Feature/Services/Social/RedditAnalyticsTest.php
index 842ee161..177cd89c 100644
--- a/tests/Feature/Services/Social/RedditAnalyticsTest.php
+++ b/tests/Feature/Services/Social/RedditAnalyticsTest.php
@@ -12,7 +12,7 @@
 beforeEach(function () {
     config([
         'trypost.platforms.reddit.api' => 'https://oauth.reddit.com',
-        'trypost.platforms.reddit.user_agent' => 'web:it.trypost:1.0',
+        'app.user_agent' => 'web:it.trypost:1.0',
     ]);
     $this->account = SocialAccount::factory()->reddit()->create(['workspace_id' => Workspace::factory()->create()->id]);
 });
diff --git a/tests/Feature/Services/Social/RedditClientTest.php b/tests/Feature/Services/Social/RedditClientTest.php
index 09d143c3..ea22acd5 100644
--- a/tests/Feature/Services/Social/RedditClientTest.php
+++ b/tests/Feature/Services/Social/RedditClientTest.php
@@ -11,7 +11,7 @@
 beforeEach(function () {
     config([
         'trypost.platforms.reddit.api' => 'https://oauth.reddit.com',
-        'trypost.platforms.reddit.user_agent' => 'web:it.trypost:1.0',
+        'app.user_agent' => 'web:it.trypost:1.0',
     ]);
     $this->account = SocialAccount::factory()->reddit()->create([
         'workspace_id' => Workspace::factory()->create()->id,
@@ -33,6 +33,8 @@
 
     expect($results)->toHaveCount(2)
         ->and($results[0]['name'])->toBe('AskReddit');
+
+    Http::assertSent(fn ($request) => $request->hasHeader('User-Agent', config('app.user_agent')));
 });
 
 test('restrictions reports submission type, image allowance and required flair', function () {
diff --git a/tests/Feature/Services/Social/RedditPublisherTest.php b/tests/Feature/Services/Social/RedditPublisherTest.php
index 0b6f7e65..42c5b537 100644
--- a/tests/Feature/Services/Social/RedditPublisherTest.php
+++ b/tests/Feature/Services/Social/RedditPublisherTest.php
@@ -16,7 +16,7 @@
 beforeEach(function () {
     config([
         'trypost.platforms.reddit.api' => 'https://oauth.reddit.com',
-        'trypost.platforms.reddit.user_agent' => 'web:it.trypost:1.0',
+        'app.user_agent' => 'web:it.trypost:1.0',
     ]);
 
     $this->user = User::factory()->create();