TenantAtlas/app/Support/Navigation/CanonicalNavigationContext.php
2026-03-10 17:05:07 +01:00

67 lines
2.0 KiB
PHP

<?php
declare(strict_types=1);
namespace App\Support\Navigation;
use Illuminate\Http\Request;
final readonly class CanonicalNavigationContext
{
/**
* @param array<string, mixed> $filterPayload
*/
public function __construct(
public string $sourceSurface,
public string $canonicalRouteName,
public ?int $tenantId = null,
public ?string $backLinkLabel = null,
public ?string $backLinkUrl = null,
public array $filterPayload = [],
) {}
public static function fromRequest(Request $request): ?self
{
$payload = $request->query('nav');
if (! is_array($payload)) {
return null;
}
$sourceSurface = $payload['source_surface'] ?? null;
$canonicalRouteName = $payload['canonical_route_name'] ?? null;
if (! is_string($sourceSurface) || $sourceSurface === '' || ! is_string($canonicalRouteName) || $canonicalRouteName === '') {
return null;
}
$tenantId = $payload['tenant_id'] ?? null;
return new self(
sourceSurface: $sourceSurface,
canonicalRouteName: $canonicalRouteName,
tenantId: is_numeric($tenantId) ? (int) $tenantId : null,
backLinkLabel: is_string($payload['back_label'] ?? null) ? (string) $payload['back_label'] : null,
backLinkUrl: is_string($payload['back_url'] ?? null) ? (string) $payload['back_url'] : null,
filterPayload: [],
);
}
/**
* @return array<string, mixed>
*/
public function toQuery(): array
{
$query = $this->filterPayload;
$query['nav'] = array_filter([
'source_surface' => $this->sourceSurface,
'canonical_route_name' => $this->canonicalRouteName,
'tenant_id' => $this->tenantId,
'back_label' => $this->backLinkLabel,
'back_url' => $this->backLinkUrl,
], static fn (mixed $value): bool => $value !== null && $value !== '');
return $query;
}
}