$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 */ 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; } }