Repo rebuild

2026-09-15 12:33:28 +01:00
commit be28c4feec
5629 changed files with 317074 additions and 0 deletions
@@ -0,0 +1,94 @@
+<?php
+
+namespace Modules\Countries\Http\Controllers\Api;
+
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Routing\Controller;
+use Modules\Countries\Models\Country;
+use Modules\Countries\Models\CountrySubdivision;
+use Modules\Countries\Support\CountryRepository;
+
+class CountriesApiController extends Controller
+{
+    /**
+     * List ISO 3166-1 countries for integrations and selectors.
+     */
+    public function index(Request $request): JsonResponse
+    {
+        $activeOnly = $request->boolean('active_only', false);
+        $search = trim((string) $request->query('search', ''));
+
+        $countries = Country::query()
+            ->when($activeOnly, fn ($query) => $query->where('is_active', true))
+            ->when($search !== '', function ($query) use ($search): void {
+                $query->where(function ($nested) use ($search): void {
+                    $nested->where('name', 'ilike', "%{$search}%")
+                        ->orWhere('official_name', 'ilike', "%{$search}%")
+                        ->orWhere('common_name', 'ilike', "%{$search}%")
+                        ->orWhere('display_name', 'ilike', "%{$search}%")
+                        ->orWhere('native_name', 'ilike', "%{$search}%")
+                        ->orWhere('alpha2', 'ilike', "%{$search}%")
+                        ->orWhere('alpha3', 'ilike', "%{$search}%")
+                        ->orWhere('numeric', 'ilike', "%{$search}%")
+                        ->orWhere('region', 'ilike', "%{$search}%")
+                        ->orWhere('subregion', 'ilike', "%{$search}%")
+                        ->orWhere('currency_code', 'ilike', "%{$search}%")
+                        ->orWhere('calling_code', 'ilike', "%{$search}%");
+                });
+            })
+            ->ordered()
+            ->get();
+
+        return response()->json(['data' => $countries]);
+    }
+
+    /**
+     * List active ISO 3166-1 countries for business selectors.
+     */
+    public function active(): JsonResponse
+    {
+        $countries = Country::query()->active()->ordered()->get();
+
+        return response()->json(['data' => $countries]);
+    }
+
+    /**
+     * Show one country by alpha-2 route binding.
+     */
+    public function show(Country $country): JsonResponse
+    {
+        return response()->json(['data' => $country->loadCount('subdivisions')]);
+    }
+
+    /**
+     * Resolve alpha-2, alpha-3 or numeric ISO 3166-1 country code.
+     */
+    public function resolve(string $code, CountryRepository $countries): JsonResponse
+    {
+        $country = $countries->findByIsoCode($code);
+
+        abort_if($country === null, 404, 'Country code not found.');
+
+        return response()->json(['data' => $country]);
+    }
+
+    /**
+     * List ISO 3166-2 subdivisions for the supplied ISO 3166-1 alpha-2 country.
+     */
+    public function subdivisions(string $alpha2, Request $request, CountryRepository $countries): JsonResponse
+    {
+        $activeOnly = $request->boolean('active_only', true);
+        $country = $countries->findByAlpha2($alpha2);
+
+        abort_if($country === null, 404, 'Country not found.');
+
+        $subdivisions = CountrySubdivision::query()
+            ->where('country_id', $country->id)
+            ->when($activeOnly, fn ($query) => $query->where('is_active', true))
+            ->ordered()
+            ->get();
+
+        return response()->json(['data' => $subdivisions]);
+    }
+}