10.April 2026

app/Services/LocaleGuard.php

@@ -0,0 +1,30 @@
+<?php
+
+namespace App\Services;
+
+class LocaleGuard
+{
+    /**
+     * @return array<int, string>
+     */
+    public static function supportedLocaleCodes(): array
+    {
+        return array_keys(config('localization.supportedLocales'));
+    }
+
+    public static function isSupported(string $locale): bool
+    {
+        return in_array(strtolower($locale), self::supportedLocaleCodes(), true);
+    }
+
+    public static function normalize(?string $locale): ?string
+    {
+        if ($locale === null || $locale === '') {
+            return null;
+        }
+
+        $lower = strtolower($locale);
+
+        return self::isSupported($lower) ? $lower : null;
+    }
+}