feat: add webhooks:cleanup command with configurable retention

- New artisan command: webhooks:cleanup [--days=N]
- Config option retention_days (null = keep forever)
- Force-deletes webhooks older than retention period
- Registered via Spatie package tools hasCommand()

Author: danielhe4rt

config/filament-webhooks.php

@@ -16,4 +16,6 @@
     'model' => InboundWebhook::class,
     'providers_enum' => InboundWebhookSource::class,
     'view_any' => true,
+
+    'retention_days' => null, // null = keep forever, e.g. 30 = delete after 30 days
 ];

src/Commands/CleanupWebhooksCommand.php

@@ -0,0 +1,37 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Basement\Webhooks\Commands;
+
+use Basement\Webhooks\Models\InboundWebhook;
+use Illuminate\Console\Command;
+
+final class CleanupWebhooksCommand extends Command
+{
+    protected $signature = 'webhooks:cleanup {--days= : Number of days to retain}';
+
+    protected $description = 'Delete inbound webhooks older than the configured retention period';
+
+    public function handle(): int
+    {
+        $days = $this->option('days') ?? config('filament-webhooks.retention_days');
+
+        if ($days === null) {
+            $this->info('No retention period configured. Skipping cleanup.');
+
+            return self::SUCCESS;
+        }
+
+        $days = (int) $days;
+
+        /** @var class-string<InboundWebhook> $modelClass */
+        $modelClass = config('filament-webhooks.model', InboundWebhook::class);
+
+        $count = $modelClass::where('created_at', '<', now()->subDays($days))->forceDelete();
+
+        $this->info("Deleted {$count} webhooks older than {$days} days.");
+
+        return self::SUCCESS;
+    }
+}

src/WebhooksServiceProvider.php

@@ -5,6 +5,7 @@
 namespace Basement\Webhooks;
 
 use Basement\Webhooks\Actions\StoreInboundWebhook;
+use Basement\Webhooks\Commands\CleanupWebhooksCommand;
 use Basement\Webhooks\Contracts\StoresInboundWebhook;
 use Basement\Webhooks\Models\InboundWebhook;
 use Illuminate\Database\Eloquent\Relations\Relation;
@@ -31,6 +32,7 @@ public function configurePackage(Package $package): void
         $package
             ->name('filament-webhooks')
             ->hasConfigFile()
+            ->hasCommand(CleanupWebhooksCommand::class)
             ->discoversMigrations();
     }