breadcrumb-the-shire/modules/audit/lib/Module/Audit/Handler/SystemAuditPurgeJobHandler.php

<?php

namespace MintyPHP\Module\Audit\Handler;

use MintyPHP\Module\Audit\Service\SystemAuditService;
use MintyPHP\Service\Scheduler\Handler\ScheduledJobHandlerInterface;

class SystemAuditPurgeJobHandler implements ScheduledJobHandlerInterface
{
    public function __construct(private readonly SystemAuditService $systemAuditService)
    {
    }

    public function definition(): array
    {
        return [
            'label' => 'System audit purge',
            'description' => 'Purges system audit entries by retention policy',
            'default_enabled' => 1,
            'default_timezone' => defined('APP_TIMEZONE') ? (string) APP_TIMEZONE : 'UTC',
            'default_schedule_type' => 'daily',
            'default_schedule_interval' => 1,
            'default_schedule_time' => '03:00',
            'default_schedule_weekdays_csv' => null,
            'default_catchup_once' => 1,
            'allowed_schedule_types' => ['hourly', 'daily', 'weekly'],
        ];
    }

    public function execute(?int $actorUserId): array
    {
        $deleted = $this->systemAuditService->purgeExpired();

        return [
            'status' => 'success',
            'error_code' => null,
            'error_message' => null,
            'result' => ['deleted_count' => $deleted],
        ];
    }
}