Add Phase 2 remote browse scaffolding for /Clients

webui/backend/app/services/remote_client_service.py

@@ -27,14 +27,30 @@ class RemoteClientService:
         self._now = now or (lambda: datetime.now(tz=timezone.utc))
 
     def list_clients(self) -> RemoteClientListResponse:
-        now = self._now()
-        self._repository.mark_stale_clients_offline(
-            cutoff_iso=self._to_iso(now - timedelta(seconds=self._offline_timeout_seconds)),
-            now_iso=self._to_iso(now),
-        )
+        self._refresh_stale_statuses()
         items = [RemoteClientItem(**row) for row in self._repository.list_clients()]
         return RemoteClientListResponse(items=items)
 
+    def get_client(self, client_id: str) -> RemoteClientItem:
+        normalized_client_id = (client_id or "").strip()
+        if not normalized_client_id:
+            raise AppError(
+                code="invalid_request",
+                message="client_id is required",
+                status_code=400,
+                details={"client_id": client_id},
+            )
+        self._refresh_stale_statuses()
+        item = self._repository.get_client(normalized_client_id)
+        if item is None:
+            raise AppError(
+                code="path_not_found",
+                message="Remote client was not found",
+                status_code=404,
+                details={"client_id": normalized_client_id},
+            )
+        return RemoteClientItem(**item)
+
     def register_client(self, authorization: str | None, request: RemoteClientRegisterRequest) -> RemoteClientItem:
         self._require_registration_auth(authorization)
         payload = self._normalize_register_request(request)
@@ -123,6 +139,13 @@ class RemoteClientService:
             "shares": shares,
         }
 
+    def _refresh_stale_statuses(self) -> None:
+        now = self._now()
+        self._repository.mark_stale_clients_offline(
+            cutoff_iso=self._to_iso(now - timedelta(seconds=self._offline_timeout_seconds)),
+            now_iso=self._to_iso(now),
+        )
+
     @staticmethod
     def _to_iso(value: datetime) -> str:
         return value.astimezone(timezone.utc).isoformat().replace("+00:00", "Z")