added countries support expanded for ISO 3166 standard

Modules/Countries/Models/Country.php

@@ -5,6 +5,7 @@ namespace Modules\Countries\Models;
 use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\HasMany;
 
 class Country extends Model
 {
@@ -12,13 +13,16 @@ class Country extends Model
 
     protected $fillable = [
         'alpha2', 'alpha3', 'numeric', 'name', 'official_name', 'common_name',
-        'display_name', 'flag_emoji', 'is_active', 'sort_order', 'last_synced_at',
+        'display_name', 'flag_emoji', 'is_active', 'iso_status', 'independent', 'region', 'subregion',
+        'sort_order', 'last_synced_at', 'source', 'source_version', 'metadata',
     ];
 
     protected $casts = [
         'is_active' => 'boolean',
         'sort_order' => 'integer',
         'last_synced_at' => 'datetime',
+        'independent' => 'boolean',
+        'metadata' => 'array',
     ];
 
     public function getRouteKeyName(): string
@@ -31,6 +35,30 @@ class Country extends Model
         return $this->display_name ?: $this->common_name ?: $this->name;
     }
 
+
+
+    /**
+     * ISO 3166-2 subdivisions belonging to this country.
+     */
+    public function subdivisions(): HasMany
+    {
+        return $this->hasMany(CountrySubdivision::class);
+    }
+
+    /**
+     * Resolve a country from alpha-2, alpha-3 or numeric ISO 3166-1 code.
+     */
+    public function scopeForIsoCode(Builder $query, string $code): Builder
+    {
+        $normalised = strtoupper(trim($code));
+
+        return $query->where(function (Builder $nested) use ($normalised): void {
+            $nested->where('alpha2', $normalised)
+                ->orWhere('alpha3', $normalised)
+                ->orWhere('numeric', str_pad($normalised, 3, '0', STR_PAD_LEFT));
+        });
+    }
+
     public function scopeActive(Builder $query): Builder
     {
         return $query->where('is_active', true);