unique-search-proxy-core 2026.44.0.dev0__tar.gz → 2026.44.0.dev2__tar.gz

{unique_search_proxy_core-2026.44.0.dev0 → unique_search_proxy_core-2026.44.0.dev2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: unique-search-proxy-core
-Version: 2026.44.0.dev0
+Version: 2026.44.0.dev2
 Summary: Shared Pydantic types for the Unique Search Proxy API
 Author: ThePhilAz
 Author-email: ThePhilAz <rami.azouz@philico.com>
@@ -8,7 +8,7 @@ Requires-Dist: httpx>=0.28.0,<0.29
 Requires-Dist: pydantic>=2.12.5,<3.0.0
 Requires-Dist: pydantic-settings>=2.10.1,<3
 Requires-Dist: pyhumps>=3.8.0,<4
-Requires-Dist: unique-toolkit[monitoring]>=2026.44.0.dev0,<2026.44.0rc0
+Requires-Dist: unique-toolkit[monitoring]>=2026.44.0.dev7,<2026.44.0rc0
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 

{unique_search_proxy_core-2026.44.0.dev0 → unique_search_proxy_core-2026.44.0.dev2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "unique-search-proxy-core"
-version = "2026.44.0.dev0"
+version = "2026.44.0.dev2"
 description = "Shared Pydantic types for the Unique Search Proxy API"
 authors = [{ name = "ThePhilAz", email = "rami.azouz@philico.com" }]
 readme = "README.md"
@@ -10,7 +10,7 @@ dependencies = [
     "pydantic>=2.12.5,<3.0.0",
     "pydantic-settings>=2.10.1,<3",
     "pyhumps>=3.8.0,<4",
-    "unique-toolkit[monitoring]>=2026.44.0.dev0,<2026.44.0rc0",
+    "unique-toolkit[monitoring]>=2026.44.0.dev7,<2026.44.0rc0",
 
 ]
 

{unique_search_proxy_core-2026.44.0.dev0 → unique_search_proxy_core-2026.44.0.dev2}/unique_search_proxy_core/http_client/__init__.py

@@ -5,6 +5,7 @@ from unique_search_proxy_core.http_client.client import (
     EgressRoute,
     HttpClientRegistry,
     ProxiedRoute,
+    ResolvedEgress,
     async_client_factory,
     build_async_client,
     build_route,
@@ -38,6 +39,7 @@ __all__ = [
     "ProxyProtocol",
     "ProxySettings",
     "ProxyUsernameSource",
+    "ResolvedEgress",
     "SettingsProxyCredentials",
     "UserMetadataProxyCredentials",
     "async_client_factory",

{unique_search_proxy_core-2026.44.0.dev0 → unique_search_proxy_core-2026.44.0.dev2}/unique_search_proxy_core/http_client/client.py

@@ -57,6 +57,14 @@ class ProxiedRoute:
 EgressRoute = DirectRoute | ProxiedRoute
 
 
+@dataclass(frozen=True)
+class ResolvedEgress:
+    """HTTP client and route resolved from one request credential set."""
+
+    http_client: AsyncClient
+    route: EgressRoute
+
+
 def _get_proxy_host_and_port(settings: ProxySettings) -> tuple[str, int]:
     proxy_host = settings.proxy_host
     proxy_port = settings.proxy_port
@@ -314,20 +322,51 @@ class HttpClientRegistry:
             fixed_client=client,
         )
 
-    async def client_for(self, context: RequestContext) -> AsyncClient:
-        """Return the cached client for the request's resolved credentials."""
-        if self._fixed_client is not None:
-            return self._fixed_client
+    async def egress_for(self, context: RequestContext) -> ResolvedEgress:
+        """Return the cached client and route for one credential resolution."""
         if self._closed:
             raise RuntimeError("HTTP client registry is closed")
-
         credentials = self._resolver.resolve(context)
+        return await self._egress_for_credentials(credentials)
+
+    async def settings_egress(self) -> ResolvedEgress:
+        """Return egress for process-level work using settings credentials."""
+        if self._closed:
+            raise RuntimeError("HTTP client registry is closed")
+        if (
+            self._settings.proxy_username_source == "user_metadata"
+            and self._settings.proxy_auth_mode == "none"
+        ):
+            raise ValidationProxyError(
+                "Process-level egress cannot use request-scoped proxy credentials; "
+                "configure settings-backed username/password or mTLS credentials",
+            )
+        credentials = SettingsProxyCredentials(self._settings).resolve(
+            RequestContext(
+                company_id="__settings__",
+                user_id="local",
+                chat_id="local",
+            ),
+        )
+        return await self._egress_for_credentials(credentials)
+
+    async def _egress_for_credentials(
+        self,
+        credentials: ProxyCredentials,
+    ) -> ResolvedEgress:
+        if self._closed:
+            raise RuntimeError("HTTP client registry is closed")
+
+        route = build_route(self._settings, credentials)
+        if self._fixed_client is not None:
+            return ResolvedEgress(http_client=self._fixed_client, route=route)
+
         evicted: AsyncClient | None = None
         async with self._lock:
             cached = self._clients.get(credentials)
             if cached is not None:
                 self._clients.move_to_end(credentials)
-                return cached
+                return ResolvedEgress(http_client=cached, route=route)
 
             client = build_async_client(
                 self._settings,
@@ -350,7 +389,11 @@ class HttpClientRegistry:
 
         if evicted is not None:
             await evicted.aclose()
-        return client
+        return ResolvedEgress(http_client=client, route=route)
+
+    async def client_for(self, context: RequestContext) -> AsyncClient:
+        """Return the cached client for the request's resolved credentials."""
+        return (await self.egress_for(context)).http_client
 
     @property
     def is_open(self) -> bool:
@@ -384,6 +427,7 @@ __all__ = [
     "EgressRoute",
     "HttpClientRegistry",
     "ProxiedRoute",
+    "ResolvedEgress",
     "async_client_factory",
     "build_async_client",
     "build_route",