feat(api): manual updates

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 12
+configured_endpoints: 13
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/brand-dev%2Fbrand.dev-f69782c2c4296df9db6b41a3a7359a9e4910f59e34901b9f0e8045cec3f9ca69.yml
 openapi_spec_hash: f06c3956a6fc7e57614b120910339747
-config_hash: 86160e220c81f47769a71c9343e486d8
+config_hash: 6aaf0fe6f8877c9c5d9af95597123cb4

api.md

@@ -6,6 +6,7 @@ Types:
 from brand.dev.types import (
     BrandRetrieveResponse,
     BrandAIQueryResponse,
+    BrandFontsResponse,
     BrandIdentifyFromTransactionResponse,
     BrandPrefetchResponse,
     BrandRetrieveByEmailResponse,
@@ -23,6 +24,7 @@ Methods:
 
 - <code title="get /brand/retrieve">client.brand.<a href="./src/brand/dev/resources/brand.py">retrieve</a>(\*\*<a href="src/brand/dev/types/brand_retrieve_params.py">params</a>) -> <a href="./src/brand/dev/types/brand_retrieve_response.py">BrandRetrieveResponse</a></code>
 - <code title="post /brand/ai/query">client.brand.<a href="./src/brand/dev/resources/brand.py">ai_query</a>(\*\*<a href="src/brand/dev/types/brand_ai_query_params.py">params</a>) -> <a href="./src/brand/dev/types/brand_ai_query_response.py">BrandAIQueryResponse</a></code>
+- <code title="get /brand/fonts">client.brand.<a href="./src/brand/dev/resources/brand.py">fonts</a>(\*\*<a href="src/brand/dev/types/brand_fonts_params.py">params</a>) -> <a href="./src/brand/dev/types/brand_fonts_response.py">BrandFontsResponse</a></code>
 - <code title="get /brand/transaction_identifier">client.brand.<a href="./src/brand/dev/resources/brand.py">identify_from_transaction</a>(\*\*<a href="src/brand/dev/types/brand_identify_from_transaction_params.py">params</a>) -> <a href="./src/brand/dev/types/brand_identify_from_transaction_response.py">BrandIdentifyFromTransactionResponse</a></code>
 - <code title="post /brand/prefetch">client.brand.<a href="./src/brand/dev/resources/brand.py">prefetch</a>(\*\*<a href="src/brand/dev/types/brand_prefetch_params.py">params</a>) -> <a href="./src/brand/dev/types/brand_prefetch_response.py">BrandPrefetchResponse</a></code>
 - <code title="get /brand/retrieve-by-email">client.brand.<a href="./src/brand/dev/resources/brand.py">retrieve_by_email</a>(\*\*<a href="src/brand/dev/types/brand_retrieve_by_email_params.py">params</a>) -> <a href="./src/brand/dev/types/brand_retrieve_by_email_response.py">BrandRetrieveByEmailResponse</a></code>

src/brand/dev/resources/brand.py

@@ -8,6 +8,7 @@
 import httpx
 
 from ..types import (
+    brand_fonts_params,
     brand_ai_query_params,
     brand_prefetch_params,
     brand_retrieve_params,
@@ -32,6 +33,7 @@
     async_to_streamed_response_wrapper,
 )
 from .._base_client import make_request_options
+from ..types.brand_fonts_response import BrandFontsResponse
 from ..types.brand_ai_query_response import BrandAIQueryResponse
 from ..types.brand_prefetch_response import BrandPrefetchResponse
 from ..types.brand_retrieve_response import BrandRetrieveResponse
@@ -239,6 +241,56 @@ def ai_query(
             cast_to=BrandAIQueryResponse,
         )
 
+    def fonts(
+        self,
+        *,
+        domain: str,
+        timeout_ms: int | Omit = omit,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> BrandFontsResponse:
+        """
+        Beta feature: Extract font information from a brand's website including font
+        families, usage statistics, fallbacks, and element/word counts.
+
+        Args:
+          domain: Domain name to extract fonts from (e.g., 'example.com', 'google.com'). The
+              domain will be automatically normalized and validated.
+
+          timeout_ms: Optional timeout in milliseconds for the request. If the request takes longer
+              than this value, it will be aborted with a 408 status code. Maximum allowed
+              value is 300000ms (5 minutes).
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return self._get(
+            "/brand/fonts",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform(
+                    {
+                        "domain": domain,
+                        "timeout_ms": timeout_ms,
+                    },
+                    brand_fonts_params.BrandFontsParams,
+                ),
+            ),
+            cast_to=BrandFontsResponse,
+        )
+
     def identify_from_transaction(
         self,
         *,
@@ -1612,6 +1664,56 @@ async def ai_query(
             cast_to=BrandAIQueryResponse,
         )
 
+    async def fonts(
+        self,
+        *,
+        domain: str,
+        timeout_ms: int | Omit = omit,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> BrandFontsResponse:
+        """
+        Beta feature: Extract font information from a brand's website including font
+        families, usage statistics, fallbacks, and element/word counts.
+
+        Args:
+          domain: Domain name to extract fonts from (e.g., 'example.com', 'google.com'). The
+              domain will be automatically normalized and validated.
+
+          timeout_ms: Optional timeout in milliseconds for the request. If the request takes longer
+              than this value, it will be aborted with a 408 status code. Maximum allowed
+              value is 300000ms (5 minutes).
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return await self._get(
+            "/brand/fonts",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=await async_maybe_transform(
+                    {
+                        "domain": domain,
+                        "timeout_ms": timeout_ms,
+                    },
+                    brand_fonts_params.BrandFontsParams,
+                ),
+            ),
+            cast_to=BrandFontsResponse,
+        )
+
     async def identify_from_transaction(
         self,
         *,
@@ -2804,6 +2906,9 @@ def __init__(self, brand: BrandResource) -> None:
         self.ai_query = to_raw_response_wrapper(
             brand.ai_query,
         )
+        self.fonts = to_raw_response_wrapper(
+            brand.fonts,
+        )
         self.identify_from_transaction = to_raw_response_wrapper(
             brand.identify_from_transaction,
         )
@@ -2846,6 +2951,9 @@ def __init__(self, brand: AsyncBrandResource) -> None:
         self.ai_query = async_to_raw_response_wrapper(
             brand.ai_query,
         )
+        self.fonts = async_to_raw_response_wrapper(
+            brand.fonts,
+        )
         self.identify_from_transaction = async_to_raw_response_wrapper(
             brand.identify_from_transaction,
         )
@@ -2888,6 +2996,9 @@ def __init__(self, brand: BrandResource) -> None:
         self.ai_query = to_streamed_response_wrapper(
             brand.ai_query,
         )
+        self.fonts = to_streamed_response_wrapper(
+            brand.fonts,
+        )
         self.identify_from_transaction = to_streamed_response_wrapper(
             brand.identify_from_transaction,
         )
@@ -2930,6 +3041,9 @@ def __init__(self, brand: AsyncBrandResource) -> None:
         self.ai_query = async_to_streamed_response_wrapper(
             brand.ai_query,
         )
+        self.fonts = async_to_streamed_response_wrapper(
+            brand.fonts,
+        )
         self.identify_from_transaction = async_to_streamed_response_wrapper(
             brand.identify_from_transaction,
         )

src/brand/dev/types/__init__.py

@@ -2,6 +2,8 @@
 
 from __future__ import annotations
 
+from .brand_fonts_params import BrandFontsParams as BrandFontsParams
+from .brand_fonts_response import BrandFontsResponse as BrandFontsResponse
 from .brand_ai_query_params import BrandAIQueryParams as BrandAIQueryParams
 from .brand_prefetch_params import BrandPrefetchParams as BrandPrefetchParams
 from .brand_retrieve_params import BrandRetrieveParams as BrandRetrieveParams

src/brand/dev/types/brand_fonts_params.py

@@ -0,0 +1,24 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, Annotated, TypedDict
+
+from .._utils import PropertyInfo
+
+__all__ = ["BrandFontsParams"]
+
+
+class BrandFontsParams(TypedDict, total=False):
+    domain: Required[str]
+    """Domain name to extract fonts from (e.g., 'example.com', 'google.com').
+
+    The domain will be automatically normalized and validated.
+    """
+
+    timeout_ms: Annotated[int, PropertyInfo(alias="timeoutMS")]
+    """Optional timeout in milliseconds for the request.
+
+    If the request takes longer than this value, it will be aborted with a 408
+    status code. Maximum allowed value is 300000ms (5 minutes).
+    """

src/brand/dev/types/brand_fonts_response.py

@@ -0,0 +1,44 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+
+from .._models import BaseModel
+
+__all__ = ["BrandFontsResponse", "Font"]
+
+
+class Font(BaseModel):
+    fallbacks: List[str]
+    """Array of fallback font families"""
+
+    font: str
+    """Font family name"""
+
+    num_elements: float
+    """Number of elements using this font"""
+
+    num_words: float
+    """Number of words using this font"""
+
+    percent_elements: float
+    """Percentage of elements using this font"""
+
+    percent_words: float
+    """Percentage of words using this font"""
+
+    uses: List[str]
+    """Array of CSS selectors or element types where this font is used"""
+
+
+class BrandFontsResponse(BaseModel):
+    code: int
+    """HTTP status code, e.g., 200"""
+
+    domain: str
+    """The normalized domain that was processed"""
+
+    fonts: List[Font]
+    """Array of font usage information"""
+
+    status: str
+    """Status of the response, e.g., 'ok'"""

tests/api_resources/test_brand.py

@@ -10,6 +10,7 @@
 from brand.dev import BrandDev, AsyncBrandDev
 from tests.utils import assert_matches_type
 from brand.dev.types import (
+    BrandFontsResponse,
     BrandAIQueryResponse,
     BrandPrefetchResponse,
     BrandRetrieveResponse,
@@ -154,6 +155,49 @@ def test_streaming_response_ai_query(self, client: BrandDev) -> None:
 
         assert cast(Any, response.is_closed) is True
 
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    def test_method_fonts(self, client: BrandDev) -> None:
+        brand = client.brand.fonts(
+            domain="domain",
+        )
+        assert_matches_type(BrandFontsResponse, brand, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    def test_method_fonts_with_all_params(self, client: BrandDev) -> None:
+        brand = client.brand.fonts(
+            domain="domain",
+            timeout_ms=1,
+        )
+        assert_matches_type(BrandFontsResponse, brand, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    def test_raw_response_fonts(self, client: BrandDev) -> None:
+        response = client.brand.with_raw_response.fonts(
+            domain="domain",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        brand = response.parse()
+        assert_matches_type(BrandFontsResponse, brand, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    def test_streaming_response_fonts(self, client: BrandDev) -> None:
+        with client.brand.with_streaming_response.fonts(
+            domain="domain",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            brand = response.parse()
+            assert_matches_type(BrandFontsResponse, brand, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
     @pytest.mark.skip(reason="Prism tests are disabled")
     @parametrize
     def test_method_identify_from_transaction(self, client: BrandDev) -> None:
@@ -731,6 +775,49 @@ async def test_streaming_response_ai_query(self, async_client: AsyncBrandDev) ->
 
         assert cast(Any, response.is_closed) is True
 
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    async def test_method_fonts(self, async_client: AsyncBrandDev) -> None:
+        brand = await async_client.brand.fonts(
+            domain="domain",
+        )
+        assert_matches_type(BrandFontsResponse, brand, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    async def test_method_fonts_with_all_params(self, async_client: AsyncBrandDev) -> None:
+        brand = await async_client.brand.fonts(
+            domain="domain",
+            timeout_ms=1,
+        )
+        assert_matches_type(BrandFontsResponse, brand, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    async def test_raw_response_fonts(self, async_client: AsyncBrandDev) -> None:
+        response = await async_client.brand.with_raw_response.fonts(
+            domain="domain",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        brand = await response.parse()
+        assert_matches_type(BrandFontsResponse, brand, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    async def test_streaming_response_fonts(self, async_client: AsyncBrandDev) -> None:
+        async with async_client.brand.with_streaming_response.fonts(
+            domain="domain",
+        ) as response:
+            assert not response.is_closed
+            assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+
+            brand = await response.parse()
+            assert_matches_type(BrandFontsResponse, brand, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
     @pytest.mark.skip(reason="Prism tests are disabled")
     @parametrize
     async def test_method_identify_from_transaction(self, async_client: AsyncBrandDev) -> None: