<?php

declare(strict_types=1);

namespace App\Services\Audit;

use App\Models\AuditLog;
use App\Models\Tenant;
use App\Models\Workspace;
use App\Support\Audit\AuditActionId;
use App\Support\Audit\AuditActorSnapshot;
use App\Support\Audit\AuditOutcome;
use App\Support\Audit\AuditTargetSnapshot;
use Carbon\CarbonInterface;

final class AuditRecorder
{
    public function __construct(
        private readonly AuditEventBuilder $builder,
    ) {}

    /**
     * @param  array<string, mixed>  $context
     */
    public function record(
        string|AuditActionId $action,
        array $context = [],
        ?Workspace $workspace = null,
        ?Tenant $tenant = null,
        ?AuditActorSnapshot $actor = null,
        ?AuditTargetSnapshot $target = null,
        string|AuditOutcome|null $outcome = null,
        ?CarbonInterface $recordedAt = null,
        ?string $summary = null,
        ?int $operationRunId = null,
    ): AuditLog {
        $actionValue = $action instanceof AuditActionId ? $action->value : trim($action);

        return AuditLog::query()->create(
            $this->builder->buildRecordAttributes(
                action: $actionValue,
                context: $context,
                workspace: $workspace,
                tenant: $tenant,
                actor: $actor,
                target: $target,
                outcome: $outcome,
                recordedAt: $recordedAt,
                summary: $summary,
                operationRunId: $operationRunId,
            ),
        );
    }
}