TenantAtlas/app/Support/OpsUx/SummaryCountsNormalizer.php

<?php

declare(strict_types=1);

namespace App\Support\OpsUx;

use App\Support\ReasonTranslation\ReasonTranslator;

final class SummaryCountsNormalizer
{
    /**
     * @param  array<string, mixed>  $summaryCounts
     * @return array<string, int>
     */
    public static function normalize(array $summaryCounts): array
    {
        $allowedKeys = array_flip(OperationSummaryKeys::all());

        $sanitized = [];

        foreach ($summaryCounts as $key => $value) {
            $key = trim((string) $key);

            if ($key === '' || ! isset($allowedKeys[$key])) {
                continue;
            }

            if (is_int($value)) {
                $sanitized[$key] = $value;

                continue;
            }

            if (is_float($value) && is_finite($value)) {
                $sanitized[$key] = (int) round($value);

                continue;
            }

            if (is_numeric($value)) {
                $sanitized[$key] = (int) $value;
            }
        }

        $ordered = [];

        foreach (OperationSummaryKeys::all() as $key) {
            if (array_key_exists($key, $sanitized)) {
                $ordered[$key] = $sanitized[$key];
            }
        }

        return $ordered;
    }

    /**
     * @param  array<string, mixed>  $summaryCounts
     */
    public static function renderSummaryLine(array $summaryCounts): ?string
    {
        $normalized = self::normalize($summaryCounts);

        if ($normalized === []) {
            return null;
        }

        $parts = [];

        foreach ($normalized as $key => $value) {
            if ($value === 0) {
                continue;
            }

            $parts[] = self::label($key).': '.$value;
        }

        if ($parts === []) {
            return null;
        }

        return implode(' · ', $parts);
    }

    /**
     * Convert a snake_case summary key to a human-readable label.
     */
    public static function label(string $key): string
    {
        $reasonCode = null;

        if (str_starts_with($key, 'reason_')) {
            $reasonCode = substr($key, strlen('reason_'));
        } elseif (str_starts_with($key, 'blocked_reason_')) {
            $reasonCode = substr($key, strlen('blocked_reason_'));
        }

        if (is_string($reasonCode) && $reasonCode !== '') {
            $translation = app(ReasonTranslator::class)->translate($reasonCode, surface: 'summary_line');

            if ($translation !== null) {
                return 'Reason: '.$translation->operatorLabel;
            }
        }

        return match ($key) {
            'total' => 'Total',
            'processed' => 'Processed',
            'succeeded' => 'Completed successfully',
            'failed' => 'Failed items',
            'skipped' => 'Skipped items',
            'items' => 'Affected items',
            'tenants' => 'Tenants',
            'created' => 'Created',
            'updated' => 'Updated',
            'deleted' => 'Deleted',
            'finding_count' => 'Findings',
            'report_count' => 'Reports',
            'operation_count' => 'Operations',
            default => ucfirst(str_replace('_', ' ', $key)),
        };
    }
}