feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 29
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-9de98d1d4d2c9a431961599cb54716212c06200a919e09adedd42244038ec07b.yml
-openapi_spec_hash: a44b7d4172c8c7cd395237738867d5cb
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/context-dev/context.dev-5280c0f42603633a06d2404b120b98d0d9aa43256d13680bbdead7579a90452a.yml
+openapi_spec_hash: 34869d638c12bf076949bb7e050dd634
 config_hash: ff35e224e809656528c44163aa41bebd

src/context/dev/types/utility_prefetch_params.py

@@ -2,11 +2,17 @@
 
 from __future__ import annotations
 
-from typing_extensions import Literal, Required, Annotated, TypedDict
+from typing import Union
+from typing_extensions import Literal, Required, Annotated, TypeAlias, TypedDict
 
 from .._utils import PropertyInfo
 
-__all__ = ["UtilityPrefetchParams", "Identifier"]
+__all__ = [
+    "UtilityPrefetchParams",
+    "Identifier",
+    "IdentifierUtilityPrefetchDomainIdentifier",
+    "IdentifierUtilityPrefetchEmailIdentifier",
+]
 
 
 class UtilityPrefetchParams(TypedDict, total=False):
@@ -24,15 +30,22 @@ class UtilityPrefetchParams(TypedDict, total=False):
     """
 
 
-class Identifier(TypedDict, total=False):
-    """Identifier of the brand to prefetch. Provide exactly one of domain or email."""
+class IdentifierUtilityPrefetchDomainIdentifier(TypedDict, total=False):
+    """Prefetch brand data by domain."""
 
-    domain: str
+    domain: Required[str]
     """Domain name to prefetch brand data for"""
 
-    email: str
+
+class IdentifierUtilityPrefetchEmailIdentifier(TypedDict, total=False):
+    """Prefetch brand data by email. The domain will be extracted and validated."""
+
+    email: Required[str]
     """Email address to prefetch brand data for.
 
     The domain will be extracted from the email. Free email providers (gmail.com,
     yahoo.com, etc.) and disposable email addresses are not allowed.
     """
+
+
+Identifier: TypeAlias = Union[IdentifierUtilityPrefetchDomainIdentifier, IdentifierUtilityPrefetchEmailIdentifier]

tests/api_resources/test_utility.py

@@ -21,7 +21,7 @@ class TestUtility:
     @parametrize
     def test_method_prefetch(self, client: ContextDev) -> None:
         utility = client.utility.prefetch(
-            identifier={},
+            identifier={"domain": "domain"},
             type="brand",
         )
         assert_matches_type(UtilityPrefetchResponse, utility, path=["response"])
@@ -30,10 +30,7 @@ def test_method_prefetch(self, client: ContextDev) -> None:
     @parametrize
     def test_method_prefetch_with_all_params(self, client: ContextDev) -> None:
         utility = client.utility.prefetch(
-            identifier={
-                "domain": "domain",
-                "email": "dev@stainless.com",
-            },
+            identifier={"domain": "domain"},
             type="brand",
             timeout_ms=1000,
         )
@@ -43,7 +40,7 @@ def test_method_prefetch_with_all_params(self, client: ContextDev) -> None:
     @parametrize
     def test_raw_response_prefetch(self, client: ContextDev) -> None:
         response = client.utility.with_raw_response.prefetch(
-            identifier={},
+            identifier={"domain": "domain"},
             type="brand",
         )
 
@@ -56,7 +53,7 @@ def test_raw_response_prefetch(self, client: ContextDev) -> None:
     @parametrize
     def test_streaming_response_prefetch(self, client: ContextDev) -> None:
         with client.utility.with_streaming_response.prefetch(
-            identifier={},
+            identifier={"domain": "domain"},
             type="brand",
         ) as response:
             assert not response.is_closed
@@ -77,7 +74,7 @@ class TestAsyncUtility:
     @parametrize
     async def test_method_prefetch(self, async_client: AsyncContextDev) -> None:
         utility = await async_client.utility.prefetch(
-            identifier={},
+            identifier={"domain": "domain"},
             type="brand",
         )
         assert_matches_type(UtilityPrefetchResponse, utility, path=["response"])
@@ -86,10 +83,7 @@ async def test_method_prefetch(self, async_client: AsyncContextDev) -> None:
     @parametrize
     async def test_method_prefetch_with_all_params(self, async_client: AsyncContextDev) -> None:
         utility = await async_client.utility.prefetch(
-            identifier={
-                "domain": "domain",
-                "email": "dev@stainless.com",
-            },
+            identifier={"domain": "domain"},
             type="brand",
             timeout_ms=1000,
         )
@@ -99,7 +93,7 @@ async def test_method_prefetch_with_all_params(self, async_client: AsyncContextD
     @parametrize
     async def test_raw_response_prefetch(self, async_client: AsyncContextDev) -> None:
         response = await async_client.utility.with_raw_response.prefetch(
-            identifier={},
+            identifier={"domain": "domain"},
             type="brand",
         )
 
@@ -112,7 +106,7 @@ async def test_raw_response_prefetch(self, async_client: AsyncContextDev) -> Non
     @parametrize
     async def test_streaming_response_prefetch(self, async_client: AsyncContextDev) -> None:
         async with async_client.utility.with_streaming_response.prefetch(
-            identifier={},
+            identifier={"domain": "domain"},
             type="brand",
         ) as response:
             assert not response.is_closed