feat: Generate OG image for each package

app/Actions/GeneratePackageOgImageAction.php

@@ -0,0 +1,53 @@
+<?php
+
+namespace App\Actions;
+
+use App\Models\Package;
+use Illuminate\Support\Str;
+use Spatie\Browsershot\Browsershot;
+
+class GeneratePackageOgImageAction
+{
+    /**
+     * Generate an OG image for a package and store it using Spatie Media Library
+     */
+    public function handle(Package $package): void
+    {
+        try {
+            $tempUrl = route('og-images.package', ['package' => $package->id]);
+
+            $storagePath = storage_path('app/public/package-og-images');
+            if (! file_exists($storagePath)) {
+                mkdir($storagePath, 0755, true);
+            }
+
+            $filename = Str::slug($package->name).'-'.Str::random(8).'.jpg';
+            $fullPath = $storagePath.'/'.$filename;
+
+            $nodePath = exec('which node') ?: '/usr/bin/node';
+            $npmPath = exec('which npm') ?: '/usr/bin/npm';
+
+            Browsershot::url($tempUrl)
+                ->setNodeBinary($nodePath)
+                ->setNpmBinary($npmPath)
+                ->windowSize(1200, 630)
+                ->waitUntilNetworkIdle()
+                ->setScreenshotType('jpeg', 90)
+                ->save($fullPath);
+
+            if (file_exists($fullPath)) {
+                $media = $package->addMedia($fullPath)
+                    ->usingName('og-image')
+                    ->usingFileName($filename)
+                    ->toMediaCollection('og-images', 'package-og-images');
+
+                \Log::info('OG Image Generated: '.$package->getFirstMediaUrl('og-images'));
+            }
+        } catch (\Exception $e) {
+            \Log::error('OG Image Generation Error: '.$e->getMessage());
+            \Log::error($e->getTraceAsString());
+
+            throw $e;
+        }
+    }
+}

app/Filament/Resources/PackageResource.php

@@ -143,7 +143,7 @@ public static function getPages(): array
         return [
             'index' => Pages\ListPackages::route('/'),
             'create' => Pages\CreatePackage::route('/create'),
-            // 'edit' => Pages\EditPackage::route('/{record}/edit'),
+            'edit' => Pages\EditPackage::route('/{record}/edit'),
         ];
     }
 }

app/Filament/Resources/PackageResource/Pages/CreatePackage.php

@@ -2,10 +2,30 @@
 
 namespace App\Filament\Resources\PackageResource\Pages;
 
+use App\Actions\GeneratePackageOgImageAction;
 use App\Filament\Resources\PackageResource;
+use Filament\Notifications\Notification;
 use Filament\Resources\Pages\CreateRecord;
 
 class CreatePackage extends CreateRecord
 {
     protected static string $resource = PackageResource::class;
+
+    protected function afterCreate(): void
+    {
+        try {
+            app(GeneratePackageOgImageAction::class)->handle($this->record);
+
+            Notification::make()
+                ->title('OG Image Generated')
+                ->success()
+                ->send();
+        } catch (\Exception $e) {
+            Notification::make()
+                ->title('Failed to generate OG image')
+                ->body($e->getMessage())
+                ->danger()
+                ->send();
+        }
+    }
 }

app/Filament/Resources/PackageResource/Pages/EditPackage.php

@@ -2,9 +2,12 @@
 
 namespace App\Filament\Resources\PackageResource\Pages;
 
+use App\Actions\GeneratePackageOgImageAction;
 use App\Filament\Resources\PackageResource;
 use Filament\Actions;
+use Filament\Notifications\Notification;
 use Filament\Resources\Pages\EditRecord;
+use Illuminate\Support\Facades\Log;
 
 class EditPackage extends EditRecord
 {
@@ -16,4 +19,29 @@ protected function getHeaderActions(): array
             Actions\DeleteAction::make(),
         ];
     }
+
+    protected function afterSave(): void
+    {
+        Log::info('EditPackage afterSave triggered', ['package_id' => $this->record->id]);
+
+        try {
+            app(GeneratePackageOgImageAction::class)->handle($this->record);
+
+            Notification::make()
+                ->title('OG Image Regenerated')
+                ->success()
+                ->send();
+        } catch (\Exception $e) {
+            Log::error('OG Image Generation Error in afterSave', [
+                'package_id' => $this->record->id,
+                'error' => $e->getMessage(),
+            ]);
+
+            Notification::make()
+                ->title('Failed to regenerate OG image')
+                ->body($e->getMessage())
+                ->danger()
+                ->send();
+        }
+    }
 }

app/Http/Controllers/OgImageController.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Models\Package;
+
+class OgImageController extends Controller
+{
+    /**
+     * Render the OG image for a package
+     *
+     * @return \Illuminate\Contracts\View\View
+     */
+    public function package(Package $package)
+    {
+        return view('og-images.package', compact('package'));
+    }
+}

app/Http/Controllers/PackageController.php

@@ -2,13 +2,15 @@
 
 namespace App\Http\Controllers;
 
+use App\Actions\GeneratePackageOgImageAction;
 use App\Http\Resources\Admin\CategoryResource;
 use App\Http\Resources\PackageResource;
 use App\Models\Category;
 use App\Models\Package;
 use App\Queries\PackageQuery;
 use App\Services\GitHubService;
 use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Log;
 use Inertia\Inertia;
 
 class PackageController extends Controller
@@ -41,11 +43,25 @@ public function index(Request $request)
     public function show(string $slug)
     {
         $package = Package::query()
+            ->with('media')
             ->select('id', 'index_id', 'name', 'slug', 'description', 'repository_url', 'meta_title', 'meta_description', 'language', 'stars', 'owner', 'owner_avatar', 'created_at')
-            ->with(['categories', 'indexes'])
+            ->with(['categories', 'indexes', 'media'])
             ->where('slug', $slug)
             ->firstOrFail();
 
+        if (! $package->hasMedia('og-images')) {
+            try {
+                app(GeneratePackageOgImageAction::class)->handle($package);
+
+                $package->load('media');
+            } catch (\Exception $e) {
+                Log::error('Failed to generate OG image in controller', [
+                    'package_id' => $package->id,
+                    'error' => $e->getMessage(),
+                ]);
+            }
+        }
+
         return Inertia::render('Package', [
             'package' => new PackageResource($package),
             'readme' => Inertia::defer(fn () => GitHubService::fetchReadmeContent($package->repository_url)),

app/Http/Resources/PackageResource.php

@@ -31,6 +31,7 @@ public function toArray(Request $request): array
             'stars' => $this->stars,
             'owner' => $this->owner,
             'owner_avatar' => $this->owner_avatar,
+            'og_image' => $this->getFirstMediaUrl('og-images'),
             'status' => $this->status,
             'created_at' => $this->created_at,
             'updated_at' => $this->updated_at,

app/Models/Package.php

@@ -24,15 +24,18 @@
 use Illuminate\Validation\Rule;
 use Laravel\Scout\Attributes\SearchUsingFullText;
 use Laravel\Scout\Searchable;
+use Spatie\MediaLibrary\HasMedia;
+use Spatie\MediaLibrary\InteractsWithMedia;
 use Thefeqy\ModelStatus\Casts\StatusCast;
 use Thefeqy\ModelStatus\Traits\HasActiveScope;
 
-class Package extends Model
+class Package extends Model implements HasMedia
 {
     use Filterable;
     use HasActiveScope;
     use HasSlug;
     use HasStatus;
+    use InteractsWithMedia;
     use Searchable;
     use SoftDeletes;
 

config/filesystems.php

@@ -90,6 +90,20 @@
             'root' => 'Indices',
         ],
 
+        'package-og-images' => [
+            'driver' => 's3',
+            'key' => env('AWS_ACCESS_KEY_ID'),
+            'secret' => env('AWS_SECRET_ACCESS_KEY'),
+            'region' => env('AWS_DEFAULT_REGION'),
+            'bucket' => env('AWS_BUCKET'),
+            'url' => env('AWS_URL'),
+            'endpoint' => env('AWS_ENDPOINT'),
+            'use_path_style_endpoint' => env('AWS_USE_PATH_STYLE_ENDPOINT', false),
+            'throw' => false,
+            'report' => false,
+            'visibility' => 'public',
+            'root' => 'package-og-images',
+        ],
     ],
 
     /*