feat(ui): Shadow UI redesign, domain management, and DNS autoconfigure (#11119)

Co-authored-by: ShadowArcanist <162910371+ShadowArcanist@users.noreply.github.com>

tests/Unit/ResolveServerIpAddressTest.php

@@ -0,0 +1,95 @@
+<?php
+
+use Illuminate\Support\Facades\Cache;
+use Tests\TestCase;
+
+uses(TestCase::class);
+
+it('returns a literal ipv4 address unchanged', function () {
+    $result = resolveServerIpAddress('203.0.113.10');
+
+    expect($result['ip'])->toBe('203.0.113.10')
+        ->and($result['configured'])->toBe('203.0.113.10')
+        ->and($result['resolved_from_hostname'])->toBeFalse();
+});
+
+it('returns a literal ipv6 address unchanged', function () {
+    $result = resolveServerIpAddress('2001:db8::1');
+
+    expect($result['ip'])->toBe('2001:db8::1')
+        ->and($result['configured'])->toBe('2001:db8::1')
+        ->and($result['resolved_from_hostname'])->toBeFalse();
+});
+
+it('strips brackets from ipv6 addresses', function () {
+    $result = resolveServerIpAddress('[2001:db8::1]');
+
+    expect($result['ip'])->toBe('2001:db8::1')
+        ->and($result['resolved_from_hostname'])->toBeFalse();
+});
+
+it('resolves localhost hostname to a real ip address', function () {
+    $result = resolveServerIpAddress('localhost');
+
+    expect($result['configured'])->toBe('localhost')
+        ->and($result['resolved_from_hostname'])->toBeTrue()
+        ->and($result['ip'])->not->toBeNull()
+        ->and(filter_var($result['ip'], FILTER_VALIDATE_IP))->not->toBeFalse();
+});
+
+it('returns nulls for empty input', function () {
+    expect(resolveServerIpAddress(null))->toMatchArray([
+        'ip' => null,
+        'configured' => null,
+        'resolved_from_hostname' => false,
+    ])->and(resolveServerIpAddress(''))->toMatchArray([
+        'ip' => null,
+        'configured' => null,
+        'resolved_from_hostname' => false,
+    ]);
+});
+
+it('keeps configured hostname when it cannot be resolved', function () {
+    $host = 'this-hostname-should-not-resolve-'.bin2hex(random_bytes(8)).'.invalid';
+    $result = resolveServerIpAddress($host);
+
+    expect($result['configured'])->toBe($host)
+        ->and($result['ip'])->toBeNull()
+        ->and($result['resolved_from_hostname'])->toBeFalse();
+});
+
+it('caches successful hostname resolutions for subsequent lookups', function () {
+    Cache::flush();
+
+    $result = resolveServerIpAddress('localhost');
+
+    expect($result['ip'])->not->toBeNull()
+        ->and(Cache::get('server-ip-resolve:localhost'))->toBe($result['ip']);
+
+    // A fresh cache hit must be preferred over re-querying DNS.
+    Cache::put('server-ip-resolve:localhost', '203.0.113.99', 60);
+
+    $cached = resolveServerIpAddress('localhost');
+
+    expect($cached['ip'])->toBe('203.0.113.99')
+        ->and($cached['configured'])->toBe('localhost')
+        ->and($cached['resolved_from_hostname'])->toBeTrue();
+});
+
+it('does not cache failed hostname resolutions', function () {
+    Cache::flush();
+
+    $host = 'this-hostname-should-not-resolve-'.bin2hex(random_bytes(8)).'.invalid';
+    resolveServerIpAddress($host);
+
+    expect(Cache::get('server-ip-resolve:'.mb_strtolower($host)))->toBeNull();
+});
+
+it('does not use the cache for literal ip addresses', function () {
+    Cache::put('server-ip-resolve:203.0.113.10', '198.51.100.1', 60);
+
+    $result = resolveServerIpAddress('203.0.113.10');
+
+    expect($result['ip'])->toBe('203.0.113.10')
+        ->and($result['resolved_from_hostname'])->toBeFalse();
+});