feat(api): manual updates

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 14
+configured_endpoints: 15
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/brand-dev%2Fbrand.dev-c45c9faa82a7f8b0b0221deab17a0f6cc6b096906e192aea9ef535e17667008f.yml
 openapi_spec_hash: f3330c699ed3a55e48cdeecfce379e7b
-config_hash: 7f48d078645cb8331328bcd6f6ab3281
+config_hash: 6f10592c7d0c3bafefc1271472283217

api.md

@@ -5,6 +5,7 @@ Types:
 ```python
 from brand.dev.types import (
     BrandRetrieveResponse,
+    BrandAIProductsResponse,
     BrandAIQueryResponse,
     BrandFontsResponse,
     BrandIdentifyFromTransactionResponse,
@@ -24,6 +25,7 @@ from brand.dev.types import (
 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/products">client.brand.<a href="./src/brand/dev/resources/brand.py">ai_products</a>(\*\*<a href="src/brand/dev/types/brand_ai_products_params.py">params</a>) -> <a href="./src/brand/dev/types/brand_ai_products_response.py">BrandAIProductsResponse</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>

src/brand/dev/resources/brand.py

@@ -14,6 +14,7 @@
     brand_retrieve_params,
     brand_screenshot_params,
     brand_styleguide_params,
+    brand_ai_products_params,
     brand_retrieve_naics_params,
     brand_retrieve_by_isin_params,
     brand_retrieve_by_name_params,
@@ -40,6 +41,7 @@
 from ..types.brand_retrieve_response import BrandRetrieveResponse
 from ..types.brand_screenshot_response import BrandScreenshotResponse
 from ..types.brand_styleguide_response import BrandStyleguideResponse
+from ..types.brand_ai_products_response import BrandAIProductsResponse
 from ..types.brand_retrieve_naics_response import BrandRetrieveNaicsResponse
 from ..types.brand_retrieve_by_isin_response import BrandRetrieveByIsinResponse
 from ..types.brand_retrieve_by_name_response import BrandRetrieveByNameResponse
@@ -187,6 +189,58 @@ def retrieve(
             cast_to=BrandRetrieveResponse,
         )
 
+    def ai_products(
+        self,
+        *,
+        domain: str,
+        max_products: int | Omit = omit,
+        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,
+    ) -> BrandAIProductsResponse:
+        """Beta feature: Use AI to extract product information from a brand's website.
+
+        The
+        AI will analyze the website and return a list of products with details such as
+        name, description, pricing, features, and more.
+
+        Args:
+          domain: The domain name to analyze
+
+          max_products: Maximum number of products to extract.
+
+          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._post(
+            "/brand/ai/products",
+            body=maybe_transform(
+                {
+                    "domain": domain,
+                    "max_products": max_products,
+                    "timeout_ms": timeout_ms,
+                },
+                brand_ai_products_params.BrandAIProductsParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=BrandAIProductsResponse,
+        )
+
     def ai_query(
         self,
         *,
@@ -1674,6 +1728,58 @@ async def retrieve(
             cast_to=BrandRetrieveResponse,
         )
 
+    async def ai_products(
+        self,
+        *,
+        domain: str,
+        max_products: int | Omit = omit,
+        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,
+    ) -> BrandAIProductsResponse:
+        """Beta feature: Use AI to extract product information from a brand's website.
+
+        The
+        AI will analyze the website and return a list of products with details such as
+        name, description, pricing, features, and more.
+
+        Args:
+          domain: The domain name to analyze
+
+          max_products: Maximum number of products to extract.
+
+          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._post(
+            "/brand/ai/products",
+            body=await async_maybe_transform(
+                {
+                    "domain": domain,
+                    "max_products": max_products,
+                    "timeout_ms": timeout_ms,
+                },
+                brand_ai_products_params.BrandAIProductsParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=BrandAIProductsResponse,
+        )
+
     async def ai_query(
         self,
         *,
@@ -3033,6 +3139,9 @@ def __init__(self, brand: BrandResource) -> None:
         self.retrieve = to_raw_response_wrapper(
             brand.retrieve,
         )
+        self.ai_products = to_raw_response_wrapper(
+            brand.ai_products,
+        )
         self.ai_query = to_raw_response_wrapper(
             brand.ai_query,
         )
@@ -3081,6 +3190,9 @@ def __init__(self, brand: AsyncBrandResource) -> None:
         self.retrieve = async_to_raw_response_wrapper(
             brand.retrieve,
         )
+        self.ai_products = async_to_raw_response_wrapper(
+            brand.ai_products,
+        )
         self.ai_query = async_to_raw_response_wrapper(
             brand.ai_query,
         )
@@ -3129,6 +3241,9 @@ def __init__(self, brand: BrandResource) -> None:
         self.retrieve = to_streamed_response_wrapper(
             brand.retrieve,
         )
+        self.ai_products = to_streamed_response_wrapper(
+            brand.ai_products,
+        )
         self.ai_query = to_streamed_response_wrapper(
             brand.ai_query,
         )
@@ -3177,6 +3292,9 @@ def __init__(self, brand: AsyncBrandResource) -> None:
         self.retrieve = async_to_streamed_response_wrapper(
             brand.retrieve,
         )
+        self.ai_products = async_to_streamed_response_wrapper(
+            brand.ai_products,
+        )
         self.ai_query = async_to_streamed_response_wrapper(
             brand.ai_query,
         )

src/brand/dev/types/__init__.py

@@ -12,8 +12,10 @@
 from .brand_retrieve_response import BrandRetrieveResponse as BrandRetrieveResponse
 from .brand_screenshot_params import BrandScreenshotParams as BrandScreenshotParams
 from .brand_styleguide_params import BrandStyleguideParams as BrandStyleguideParams
+from .brand_ai_products_params import BrandAIProductsParams as BrandAIProductsParams
 from .brand_screenshot_response import BrandScreenshotResponse as BrandScreenshotResponse
 from .brand_styleguide_response import BrandStyleguideResponse as BrandStyleguideResponse
+from .brand_ai_products_response import BrandAIProductsResponse as BrandAIProductsResponse
 from .brand_retrieve_naics_params import BrandRetrieveNaicsParams as BrandRetrieveNaicsParams
 from .brand_retrieve_by_isin_params import BrandRetrieveByIsinParams as BrandRetrieveByIsinParams
 from .brand_retrieve_by_name_params import BrandRetrieveByNameParams as BrandRetrieveByNameParams

src/brand/dev/types/brand_ai_products_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__ = ["BrandAIProductsParams"]
+
+
+class BrandAIProductsParams(TypedDict, total=False):
+    domain: Required[str]
+    """The domain name to analyze"""
+
+    max_products: Annotated[int, PropertyInfo(alias="maxProducts")]
+    """Maximum number of products to extract."""
+
+    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_ai_products_response.py

@@ -0,0 +1,51 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from typing_extensions import Literal
+
+from .._models import BaseModel
+
+__all__ = ["BrandAIProductsResponse", "Product"]
+
+
+class Product(BaseModel):
+    description: str
+    """Description of the product"""
+
+    features: List[str]
+    """List of product features"""
+
+    name: str
+    """Name of the product"""
+
+    tags: List[str]
+    """Tags associated with the product"""
+
+    target_audience: List[str]
+    """Target audience for the product (array of strings)"""
+
+    billing_frequency: Optional[Literal["monthly", "yearly", "one_time", "usage_based"]] = None
+    """Billing frequency for the product"""
+
+    category: Optional[str] = None
+    """Category of the product"""
+
+    currency: Optional[str] = None
+    """Currency code for the price (e.g., USD, EUR)"""
+
+    image_url: Optional[str] = None
+    """URL to the product image"""
+
+    price: Optional[float] = None
+    """Price of the product"""
+
+    pricing_model: Optional[Literal["per_seat", "flat", "tiered", "freemium", "custom"]] = None
+    """Pricing model for the product"""
+
+    url: Optional[str] = None
+    """URL to the product page"""
+
+
+class BrandAIProductsResponse(BaseModel):
+    products: Optional[List[Product]] = None
+    """Array of products extracted from the website"""

tests/api_resources/test_brand.py

@@ -14,6 +14,7 @@
     BrandAIQueryResponse,
     BrandPrefetchResponse,
     BrandRetrieveResponse,
+    BrandAIProductsResponse,
     BrandScreenshotResponse,
     BrandStyleguideResponse,
     BrandRetrieveNaicsResponse,
@@ -71,6 +72,50 @@ def test_streaming_response_retrieve(self, client: BrandDev) -> None:
 
         assert cast(Any, response.is_closed) is True
 
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    def test_method_ai_products(self, client: BrandDev) -> None:
+        brand = client.brand.ai_products(
+            domain="domain",
+        )
+        assert_matches_type(BrandAIProductsResponse, brand, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    def test_method_ai_products_with_all_params(self, client: BrandDev) -> None:
+        brand = client.brand.ai_products(
+            domain="domain",
+            max_products=1,
+            timeout_ms=1,
+        )
+        assert_matches_type(BrandAIProductsResponse, brand, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    def test_raw_response_ai_products(self, client: BrandDev) -> None:
+        response = client.brand.with_raw_response.ai_products(
+            domain="domain",
+        )
+
+        assert response.is_closed is True
+        assert response.http_request.headers.get("X-Stainless-Lang") == "python"
+        brand = response.parse()
+        assert_matches_type(BrandAIProductsResponse, brand, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    def test_streaming_response_ai_products(self, client: BrandDev) -> None:
+        with client.brand.with_streaming_response.ai_products(
+            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(BrandAIProductsResponse, brand, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
     @pytest.mark.skip(reason="Prism tests are disabled")
     @parametrize
     def test_method_ai_query(self, client: BrandDev) -> None:
@@ -743,6 +788,50 @@ async def test_streaming_response_retrieve(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_ai_products(self, async_client: AsyncBrandDev) -> None:
+        brand = await async_client.brand.ai_products(
+            domain="domain",
+        )
+        assert_matches_type(BrandAIProductsResponse, brand, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    async def test_method_ai_products_with_all_params(self, async_client: AsyncBrandDev) -> None:
+        brand = await async_client.brand.ai_products(
+            domain="domain",
+            max_products=1,
+            timeout_ms=1,
+        )
+        assert_matches_type(BrandAIProductsResponse, brand, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    async def test_raw_response_ai_products(self, async_client: AsyncBrandDev) -> None:
+        response = await async_client.brand.with_raw_response.ai_products(
+            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(BrandAIProductsResponse, brand, path=["response"])
+
+    @pytest.mark.skip(reason="Prism tests are disabled")
+    @parametrize
+    async def test_streaming_response_ai_products(self, async_client: AsyncBrandDev) -> None:
+        async with async_client.brand.with_streaming_response.ai_products(
+            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(BrandAIProductsResponse, brand, path=["response"])
+
+        assert cast(Any, response.is_closed) is True
+
     @pytest.mark.skip(reason="Prism tests are disabled")
     @parametrize
     async def test_method_ai_query(self, async_client: AsyncBrandDev) -> None: