<?php

declare(strict_types=1);

namespace App\FormBuilder\Bindings;

use App\Models\FormBuilder\FormSubmission;
use App\Support\Json\JsonCanonicalizer;
use Spatie\Activitylog\Models\Activity;

/**
 * RFC-WS-6 §3 (Q12) — hierarchical activity log for the binding
 * pipeline. One pass-level activity (form_submission.bindings_pass_completed)
 * with N child activities (form_submission.binding_applied), linked via
 * properties.parent_activity_id.
 *
 * Failed bindings get their own binding_applied activity entry too,
 * with `error_class` / `error_message` in properties — in addition to
 * their FormSubmissionActionFailure row (deliberate dual source of
 * truth: activity_log is the human timeline, action_failures is the
 * machine-replayable workflow).
 */
final class BindingActivityLogger
{
    public function logPass(FormSubmission $submission, BindingPassResult $result): void
    {
        // RFC-WS-6 session 2.7 — canonicalize properties before they land
        // in activity_log.properties (MySQL JSON column round-trip would
        // otherwise reorder keys and break diff/regression assertions).
        $passActivity = activity()
            ->performedOn($submission)
            ->withProperties(JsonCanonicalizer::canonicalize([
                'binding_count' => count($result->applications),
                'succeeded' => $result->successCount(),
                'failed' => $result->failureCount(),
                'apply_status' => $result->applyStatus()->value,
                'person_provisioned' => $result->provisionedSubjectType === 'person',
                'subject_type' => $result->provisionedSubjectType,
                'subject_id' => $result->provisionedSubjectId,
            ]))
            ->log('form_submission.bindings_pass_completed');

        $parentActivityId = $passActivity instanceof Activity ? (string) $passActivity->id : null;

        foreach ($result->applications as $application) {
            $properties = [
                'parent_activity_id' => $parentActivityId,
                'binding_id' => $application->bindingId,
                'target_entity' => $application->targetEntity,
                'target_attribute' => $application->targetAttribute,
                'success' => $application->success,
                'old_value' => $application->oldValue,
                'new_value' => $application->newValue,
                'source_submission_id' => (string) $submission->id,
            ];
            if (! $application->success) {
                $properties['error_class'] = $application->exceptionClass;
                $properties['error_message'] = $application->exceptionMessage;
            }

            activity()
                ->performedOn($submission)
                ->withProperties(JsonCanonicalizer::canonicalize($properties))
                ->log('form_submission.binding_applied');
        }
    }
}