brand.dev 0.19.0 → 0.20.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5236e2be3cfd4c0d76d750b1cf8763549794d34ce485d269b65f28e86c264e1a
-  data.tar.gz: 2eca5ea736c10ded4bf560f2312c89122f2755e879fc9b4f3dabe68c45da8b5f
+  metadata.gz: be4fa887e23eb9143aaf2472d22397b99b414cb4ff93540d2ea3da5fbae0cfa3
+  data.tar.gz: 1c923c23ca8386e90fefe684df20b6ece1cc9455bcc9fec14d1f7cdb221cb100
 SHA512:
-  metadata.gz: 483f164eedf7a9ff9fa29cd607998493be1f611f400c4332f6b6d744788bc0b0b597a65f347fe0b51885117b202c6b546dfd5e7c415ba8a8059166302f259618
-  data.tar.gz: ec67429f2dc1d6c6807daef902ae95ae214e959b7e80d326b762946f506f61e132d3d8f59084d8819be03ea38a5b0b78e2d929c0665b4a49aef611e9e8af0aac
+  metadata.gz: ac2de9483c9ed519557f9fcff0e2ea5041c938d8fd313a934332321d79133d25081c648bad90e320ed22a09a53faada008b3dae7cf023713350382cf8289ec28
+  data.tar.gz: f82183b8ff1d77f93834c0b4cbcb100ffd3ec1fcfa2ae08f5a3d6f2fc37b8f86933c423e2b5130a1f9319313404a336ac3cc7c4855b3f788e91d971fd3fb669f

data/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.20.0 (2026-01-05)
+
+Full Changelog: [v0.19.0...v0.20.0](https://github.com/brand-dot-dev/ruby-sdk/compare/v0.19.0...v0.20.0)
+
+### Features
+
+* **api:** api update ([0e16540](https://github.com/brand-dot-dev/ruby-sdk/commit/0e1654086ce29b4db61d42d680f5c837723200c8))
+* **api:** api update ([25e7a5a](https://github.com/brand-dot-dev/ruby-sdk/commit/25e7a5a8d67e1a1f6d12ea45c9e5f8c3d0172419))
+* **api:** manual updates ([58d3d58](https://github.com/brand-dot-dev/ruby-sdk/commit/58d3d58d2f482c0b7e173dd3c1805c09af80a2c8))
+
 ## 0.19.0 (2025-12-22)
 
 Full Changelog: [v0.18.0...v0.19.0](https://github.com/brand-dot-dev/ruby-sdk/compare/v0.18.0...v0.19.0)

data/README.md

@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "brand.dev", "~> 0.19.0"
+gem "brand.dev", "~> 0.20.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/brand_dev/models/brand_ai_products_params.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module BrandDev
+  module Models
+    # @see BrandDev::Resources::Brand#ai_products
+    class BrandAIProductsParams < BrandDev::Internal::Type::BaseModel
+      extend BrandDev::Internal::Type::RequestParameters::Converter
+      include BrandDev::Internal::Type::RequestParameters
+
+      # @!attribute domain
+      #   The domain name to analyze
+      #
+      #   @return [String]
+      required :domain, String
+
+      # @!attribute max_products
+      #   Maximum number of products to extract.
+      #
+      #   @return [Integer, nil]
+      optional :max_products, Integer, api_name: :maxProducts
+
+      # @!attribute 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).
+      #
+      #   @return [Integer, nil]
+      optional :timeout_ms, Integer, api_name: :timeoutMS
+
+      # @!method initialize(domain:, max_products: nil, timeout_ms: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {BrandDev::Models::BrandAIProductsParams} for more details.
+      #
+      #   @param domain [String] The domain name to analyze
+      #
+      #   @param max_products [Integer] Maximum number of products to extract.
+      #
+      #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
+      #
+      #   @param request_options [BrandDev::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/brand_dev/models/brand_ai_products_response.rb

@@ -0,0 +1,152 @@
+# frozen_string_literal: true
+
+module BrandDev
+  module Models
+    # @see BrandDev::Resources::Brand#ai_products
+    class BrandAIProductsResponse < BrandDev::Internal::Type::BaseModel
+      # @!attribute products
+      #   Array of products extracted from the website
+      #
+      #   @return [Array<BrandDev::Models::BrandAIProductsResponse::Product>, nil]
+      optional :products,
+               -> { BrandDev::Internal::Type::ArrayOf[BrandDev::Models::BrandAIProductsResponse::Product] }
+
+      # @!method initialize(products: nil)
+      #   @param products [Array<BrandDev::Models::BrandAIProductsResponse::Product>] Array of products extracted from the website
+
+      class Product < BrandDev::Internal::Type::BaseModel
+        # @!attribute description
+        #   Description of the product
+        #
+        #   @return [String]
+        required :description, String
+
+        # @!attribute features
+        #   List of product features
+        #
+        #   @return [Array<String>]
+        required :features, BrandDev::Internal::Type::ArrayOf[String]
+
+        # @!attribute name
+        #   Name of the product
+        #
+        #   @return [String]
+        required :name, String
+
+        # @!attribute tags
+        #   Tags associated with the product
+        #
+        #   @return [Array<String>]
+        required :tags, BrandDev::Internal::Type::ArrayOf[String]
+
+        # @!attribute target_audience
+        #   Target audience for the product (array of strings)
+        #
+        #   @return [Array<String>]
+        required :target_audience, BrandDev::Internal::Type::ArrayOf[String]
+
+        # @!attribute billing_frequency
+        #   Billing frequency for the product
+        #
+        #   @return [Symbol, BrandDev::Models::BrandAIProductsResponse::Product::BillingFrequency, nil]
+        optional :billing_frequency,
+                 enum: -> { BrandDev::Models::BrandAIProductsResponse::Product::BillingFrequency },
+                 nil?: true
+
+        # @!attribute category
+        #   Category of the product
+        #
+        #   @return [String, nil]
+        optional :category, String, nil?: true
+
+        # @!attribute currency
+        #   Currency code for the price (e.g., USD, EUR)
+        #
+        #   @return [String, nil]
+        optional :currency, String, nil?: true
+
+        # @!attribute image_url
+        #   URL to the product image
+        #
+        #   @return [String, nil]
+        optional :image_url, String, nil?: true
+
+        # @!attribute price
+        #   Price of the product
+        #
+        #   @return [Float, nil]
+        optional :price, Float, nil?: true
+
+        # @!attribute pricing_model
+        #   Pricing model for the product
+        #
+        #   @return [Symbol, BrandDev::Models::BrandAIProductsResponse::Product::PricingModel, nil]
+        optional :pricing_model,
+                 enum: -> { BrandDev::Models::BrandAIProductsResponse::Product::PricingModel },
+                 nil?: true
+
+        # @!attribute url
+        #   URL to the product page
+        #
+        #   @return [String, nil]
+        optional :url, String, nil?: true
+
+        # @!method initialize(description:, features:, name:, tags:, target_audience:, billing_frequency: nil, category: nil, currency: nil, image_url: nil, price: nil, pricing_model: nil, url: nil)
+        #   @param description [String] Description of the product
+        #
+        #   @param features [Array<String>] List of product features
+        #
+        #   @param name [String] Name of the product
+        #
+        #   @param tags [Array<String>] Tags associated with the product
+        #
+        #   @param target_audience [Array<String>] Target audience for the product (array of strings)
+        #
+        #   @param billing_frequency [Symbol, BrandDev::Models::BrandAIProductsResponse::Product::BillingFrequency, nil] Billing frequency for the product
+        #
+        #   @param category [String, nil] Category of the product
+        #
+        #   @param currency [String, nil] Currency code for the price (e.g., USD, EUR)
+        #
+        #   @param image_url [String, nil] URL to the product image
+        #
+        #   @param price [Float, nil] Price of the product
+        #
+        #   @param pricing_model [Symbol, BrandDev::Models::BrandAIProductsResponse::Product::PricingModel, nil] Pricing model for the product
+        #
+        #   @param url [String, nil] URL to the product page
+
+        # Billing frequency for the product
+        #
+        # @see BrandDev::Models::BrandAIProductsResponse::Product#billing_frequency
+        module BillingFrequency
+          extend BrandDev::Internal::Type::Enum
+
+          MONTHLY = :monthly
+          YEARLY = :yearly
+          ONE_TIME = :one_time
+          USAGE_BASED = :usage_based
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # Pricing model for the product
+        #
+        # @see BrandDev::Models::BrandAIProductsResponse::Product#pricing_model
+        module PricingModel
+          extend BrandDev::Internal::Type::Enum
+
+          PER_SEAT = :per_seat
+          FLAT = :flat
+          TIERED = :tiered
+          FREEMIUM = :freemium
+          CUSTOM = :custom
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/brand_dev/models.rb

@@ -39,6 +39,8 @@ module BrandDev
     mod.define_sorbet_constant!(const) { T.type_alias { mod.to_sorbet_type } }
   end
 
+  BrandAIProductsParams = BrandDev::Models::BrandAIProductsParams
+
   BrandAIQueryParams = BrandDev::Models::BrandAIQueryParams
 
   BrandFontsParams = BrandDev::Models::BrandFontsParams

data/lib/brand_dev/resources/brand.rb

@@ -35,12 +35,43 @@ module BrandDev
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {BrandDev::Models::BrandAIProductsParams} for more details.
+      #
+      # Beta feature: Extract product information from a brand's website. Brand.dev will
+      # analyze the website and return a list of products with details such as name,
+      # description, image, pricing, features, and more.
+      #
+      # @overload ai_products(domain:, max_products: nil, timeout_ms: nil, request_options: {})
+      #
+      # @param domain [String] The domain name to analyze
+      #
+      # @param max_products [Integer] Maximum number of products to extract.
+      #
+      # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
+      #
+      # @param request_options [BrandDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [BrandDev::Models::BrandAIProductsResponse]
+      #
+      # @see BrandDev::Models::BrandAIProductsParams
+      def ai_products(params)
+        parsed, options = BrandDev::BrandAIProductsParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "brand/ai/products",
+          body: parsed,
+          model: BrandDev::Models::BrandAIProductsResponse,
+          options: options
+        )
+      end
+
       # Some parameter documentations has been truncated, see
       # {BrandDev::Models::BrandAIQueryParams} for more details.
       #
-      # Beta feature: Use AI to extract specific data points from a brand's website. The
-      # AI will crawl the website and extract the requested information based on the
-      # provided data points.
+      # Use AI to extract specific data points from a brand's website. The AI will crawl
+      # the website and extract the requested information based on the provided data
+      # points.
       #
       # @overload ai_query(data_to_extract:, domain:, specific_pages: nil, timeout_ms: nil, request_options: {})
       #
@@ -71,8 +102,8 @@ module BrandDev
       # Some parameter documentations has been truncated, see
       # {BrandDev::Models::BrandFontsParams} for more details.
       #
-      # Beta feature: Extract font information from a brand's website including font
-      # families, usage statistics, fallbacks, and element/word counts.
+      # Extract font information from a brand's website including font families, usage
+      # statistics, fallbacks, and element/word counts.
       #
       # @overload fonts(domain:, timeout_ms: nil, request_options: {})
       #
@@ -398,10 +429,10 @@ module BrandDev
       # Some parameter documentations has been truncated, see
       # {BrandDev::Models::BrandScreenshotParams} for more details.
       #
-      # Beta feature: Capture a screenshot of a website. Supports both viewport
-      # (standard browser view) and full-page screenshots. Can also screenshot specific
-      # page types (login, pricing, etc.) by using heuristics to find the appropriate
-      # URL. Returns a URL to the uploaded screenshot image hosted on our CDN.
+      # Capture a screenshot of a website. Supports both viewport (standard browser
+      # view) and full-page screenshots. Can also screenshot specific page types (login,
+      # pricing, etc.) by using heuristics to find the appropriate URL. Returns a URL to
+      # the uploaded screenshot image hosted on our CDN.
       #
       # @overload screenshot(domain:, full_screenshot: nil, page: nil, prioritize: nil, request_options: {})
       #
@@ -432,9 +463,8 @@ module BrandDev
       # Some parameter documentations has been truncated, see
       # {BrandDev::Models::BrandStyleguideParams} for more details.
       #
-      # Beta feature: Automatically extract comprehensive design system information from
-      # a brand's website including colors, typography, spacing, shadows, and UI
-      # components.
+      # Automatically extract comprehensive design system information from a brand's
+      # website including colors, typography, spacing, shadows, and UI components.
       #
       # @overload styleguide(domain:, prioritize: nil, timeout_ms: nil, request_options: {})
       #

data/lib/brand_dev/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BrandDev
-  VERSION = "0.19.0"
+  VERSION = "0.20.0"
 end

data/lib/brand_dev.rb

@@ -52,6 +52,8 @@ require_relative "brand_dev/errors"
 require_relative "brand_dev/internal/transport/base_client"
 require_relative "brand_dev/internal/transport/pooled_net_requester"
 require_relative "brand_dev/client"
+require_relative "brand_dev/models/brand_ai_products_params"
+require_relative "brand_dev/models/brand_ai_products_response"
 require_relative "brand_dev/models/brand_ai_query_params"
 require_relative "brand_dev/models/brand_ai_query_response"
 require_relative "brand_dev/models/brand_fonts_params"

data/rbi/brand_dev/models/brand_ai_products_params.rbi

@@ -0,0 +1,69 @@
+# typed: strong
+
+module BrandDev
+  module Models
+    class BrandAIProductsParams < BrandDev::Internal::Type::BaseModel
+      extend BrandDev::Internal::Type::RequestParameters::Converter
+      include BrandDev::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(BrandDev::BrandAIProductsParams, BrandDev::Internal::AnyHash)
+        end
+
+      # The domain name to analyze
+      sig { returns(String) }
+      attr_accessor :domain
+
+      # Maximum number of products to extract.
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :max_products
+
+      sig { params(max_products: Integer).void }
+      attr_writer :max_products
+
+      # 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).
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :timeout_ms
+
+      sig { params(timeout_ms: Integer).void }
+      attr_writer :timeout_ms
+
+      sig do
+        params(
+          domain: String,
+          max_products: Integer,
+          timeout_ms: Integer,
+          request_options: BrandDev::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The domain name to analyze
+        domain:,
+        # Maximum number of products to extract.
+        max_products: nil,
+        # 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).
+        timeout_ms: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            domain: String,
+            max_products: Integer,
+            timeout_ms: Integer,
+            request_options: BrandDev::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/brand_dev/models/brand_ai_products_response.rbi

@@ -0,0 +1,298 @@
+# typed: strong
+
+module BrandDev
+  module Models
+    class BrandAIProductsResponse < BrandDev::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            BrandDev::Models::BrandAIProductsResponse,
+            BrandDev::Internal::AnyHash
+          )
+        end
+
+      # Array of products extracted from the website
+      sig do
+        returns(
+          T.nilable(
+            T::Array[BrandDev::Models::BrandAIProductsResponse::Product]
+          )
+        )
+      end
+      attr_reader :products
+
+      sig do
+        params(
+          products:
+            T::Array[BrandDev::Models::BrandAIProductsResponse::Product::OrHash]
+        ).void
+      end
+      attr_writer :products
+
+      sig do
+        params(
+          products:
+            T::Array[BrandDev::Models::BrandAIProductsResponse::Product::OrHash]
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Array of products extracted from the website
+        products: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            products:
+              T::Array[BrandDev::Models::BrandAIProductsResponse::Product]
+          }
+        )
+      end
+      def to_hash
+      end
+
+      class Product < BrandDev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              BrandDev::Models::BrandAIProductsResponse::Product,
+              BrandDev::Internal::AnyHash
+            )
+          end
+
+        # Description of the product
+        sig { returns(String) }
+        attr_accessor :description
+
+        # List of product features
+        sig { returns(T::Array[String]) }
+        attr_accessor :features
+
+        # Name of the product
+        sig { returns(String) }
+        attr_accessor :name
+
+        # Tags associated with the product
+        sig { returns(T::Array[String]) }
+        attr_accessor :tags
+
+        # Target audience for the product (array of strings)
+        sig { returns(T::Array[String]) }
+        attr_accessor :target_audience
+
+        # Billing frequency for the product
+        sig do
+          returns(
+            T.nilable(
+              BrandDev::Models::BrandAIProductsResponse::Product::BillingFrequency::TaggedSymbol
+            )
+          )
+        end
+        attr_accessor :billing_frequency
+
+        # Category of the product
+        sig { returns(T.nilable(String)) }
+        attr_accessor :category
+
+        # Currency code for the price (e.g., USD, EUR)
+        sig { returns(T.nilable(String)) }
+        attr_accessor :currency
+
+        # URL to the product image
+        sig { returns(T.nilable(String)) }
+        attr_accessor :image_url
+
+        # Price of the product
+        sig { returns(T.nilable(Float)) }
+        attr_accessor :price
+
+        # Pricing model for the product
+        sig do
+          returns(
+            T.nilable(
+              BrandDev::Models::BrandAIProductsResponse::Product::PricingModel::TaggedSymbol
+            )
+          )
+        end
+        attr_accessor :pricing_model
+
+        # URL to the product page
+        sig { returns(T.nilable(String)) }
+        attr_accessor :url
+
+        sig do
+          params(
+            description: String,
+            features: T::Array[String],
+            name: String,
+            tags: T::Array[String],
+            target_audience: T::Array[String],
+            billing_frequency:
+              T.nilable(
+                BrandDev::Models::BrandAIProductsResponse::Product::BillingFrequency::OrSymbol
+              ),
+            category: T.nilable(String),
+            currency: T.nilable(String),
+            image_url: T.nilable(String),
+            price: T.nilable(Float),
+            pricing_model:
+              T.nilable(
+                BrandDev::Models::BrandAIProductsResponse::Product::PricingModel::OrSymbol
+              ),
+            url: T.nilable(String)
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Description of the product
+          description:,
+          # List of product features
+          features:,
+          # Name of the product
+          name:,
+          # Tags associated with the product
+          tags:,
+          # Target audience for the product (array of strings)
+          target_audience:,
+          # Billing frequency for the product
+          billing_frequency: nil,
+          # Category of the product
+          category: nil,
+          # Currency code for the price (e.g., USD, EUR)
+          currency: nil,
+          # URL to the product image
+          image_url: nil,
+          # Price of the product
+          price: nil,
+          # Pricing model for the product
+          pricing_model: nil,
+          # URL to the product page
+          url: nil
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              description: String,
+              features: T::Array[String],
+              name: String,
+              tags: T::Array[String],
+              target_audience: T::Array[String],
+              billing_frequency:
+                T.nilable(
+                  BrandDev::Models::BrandAIProductsResponse::Product::BillingFrequency::TaggedSymbol
+                ),
+              category: T.nilable(String),
+              currency: T.nilable(String),
+              image_url: T.nilable(String),
+              price: T.nilable(Float),
+              pricing_model:
+                T.nilable(
+                  BrandDev::Models::BrandAIProductsResponse::Product::PricingModel::TaggedSymbol
+                ),
+              url: T.nilable(String)
+            }
+          )
+        end
+        def to_hash
+        end
+
+        # Billing frequency for the product
+        module BillingFrequency
+          extend BrandDev::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                BrandDev::Models::BrandAIProductsResponse::Product::BillingFrequency
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          MONTHLY =
+            T.let(
+              :monthly,
+              BrandDev::Models::BrandAIProductsResponse::Product::BillingFrequency::TaggedSymbol
+            )
+          YEARLY =
+            T.let(
+              :yearly,
+              BrandDev::Models::BrandAIProductsResponse::Product::BillingFrequency::TaggedSymbol
+            )
+          ONE_TIME =
+            T.let(
+              :one_time,
+              BrandDev::Models::BrandAIProductsResponse::Product::BillingFrequency::TaggedSymbol
+            )
+          USAGE_BASED =
+            T.let(
+              :usage_based,
+              BrandDev::Models::BrandAIProductsResponse::Product::BillingFrequency::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                BrandDev::Models::BrandAIProductsResponse::Product::BillingFrequency::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+
+        # Pricing model for the product
+        module PricingModel
+          extend BrandDev::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                BrandDev::Models::BrandAIProductsResponse::Product::PricingModel
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          PER_SEAT =
+            T.let(
+              :per_seat,
+              BrandDev::Models::BrandAIProductsResponse::Product::PricingModel::TaggedSymbol
+            )
+          FLAT =
+            T.let(
+              :flat,
+              BrandDev::Models::BrandAIProductsResponse::Product::PricingModel::TaggedSymbol
+            )
+          TIERED =
+            T.let(
+              :tiered,
+              BrandDev::Models::BrandAIProductsResponse::Product::PricingModel::TaggedSymbol
+            )
+          FREEMIUM =
+            T.let(
+              :freemium,
+              BrandDev::Models::BrandAIProductsResponse::Product::PricingModel::TaggedSymbol
+            )
+          CUSTOM =
+            T.let(
+              :custom,
+              BrandDev::Models::BrandAIProductsResponse::Product::PricingModel::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                BrandDev::Models::BrandAIProductsResponse::Product::PricingModel::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/brand_dev/models.rbi

@@ -1,6 +1,8 @@
 # typed: strong
 
 module BrandDev
+  BrandAIProductsParams = BrandDev::Models::BrandAIProductsParams
+
   BrandAIQueryParams = BrandDev::Models::BrandAIQueryParams
 
   BrandFontsParams = BrandDev::Models::BrandFontsParams

data/rbi/brand_dev/resources/brand.rbi

@@ -34,9 +34,33 @@ module BrandDev
       )
       end
 
-      # Beta feature: Use AI to extract specific data points from a brand's website. The
-      # AI will crawl the website and extract the requested information based on the
-      # provided data points.
+      # Beta feature: Extract product information from a brand's website. Brand.dev will
+      # analyze the website and return a list of products with details such as name,
+      # description, image, pricing, features, and more.
+      sig do
+        params(
+          domain: String,
+          max_products: Integer,
+          timeout_ms: Integer,
+          request_options: BrandDev::RequestOptions::OrHash
+        ).returns(BrandDev::Models::BrandAIProductsResponse)
+      end
+      def ai_products(
+        # The domain name to analyze
+        domain:,
+        # Maximum number of products to extract.
+        max_products: nil,
+        # 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).
+        timeout_ms: nil,
+        request_options: {}
+      )
+      end
+
+      # Use AI to extract specific data points from a brand's website. The AI will crawl
+      # the website and extract the requested information based on the provided data
+      # points.
       sig do
         params(
           data_to_extract:
@@ -62,8 +86,8 @@ module BrandDev
       )
       end
 
-      # Beta feature: Extract font information from a brand's website including font
-      # families, usage statistics, fallbacks, and element/word counts.
+      # Extract font information from a brand's website including font families, usage
+      # statistics, fallbacks, and element/word counts.
       sig do
         params(
           domain: String,
@@ -353,10 +377,10 @@ module BrandDev
       )
       end
 
-      # Beta feature: Capture a screenshot of a website. Supports both viewport
-      # (standard browser view) and full-page screenshots. Can also screenshot specific
-      # page types (login, pricing, etc.) by using heuristics to find the appropriate
-      # URL. Returns a URL to the uploaded screenshot image hosted on our CDN.
+      # Capture a screenshot of a website. Supports both viewport (standard browser
+      # view) and full-page screenshots. Can also screenshot specific page types (login,
+      # pricing, etc.) by using heuristics to find the appropriate URL. Returns a URL to
+      # the uploaded screenshot image hosted on our CDN.
       sig do
         params(
           domain: String,
@@ -388,9 +412,8 @@ module BrandDev
       )
       end
 
-      # Beta feature: Automatically extract comprehensive design system information from
-      # a brand's website including colors, typography, spacing, shadows, and UI
-      # components.
+      # Automatically extract comprehensive design system information from a brand's
+      # website including colors, typography, spacing, shadows, and UI components.
       sig do
         params(
           domain: String,

data/sig/brand_dev/models/brand_ai_products_params.rbs

@@ -0,0 +1,36 @@
+module BrandDev
+  module Models
+    type brand_ai_products_params =
+      { domain: String, max_products: Integer, timeout_ms: Integer }
+      & BrandDev::Internal::Type::request_parameters
+
+    class BrandAIProductsParams < BrandDev::Internal::Type::BaseModel
+      extend BrandDev::Internal::Type::RequestParameters::Converter
+      include BrandDev::Internal::Type::RequestParameters
+
+      attr_accessor domain: String
+
+      attr_reader max_products: Integer?
+
+      def max_products=: (Integer) -> Integer
+
+      attr_reader timeout_ms: Integer?
+
+      def timeout_ms=: (Integer) -> Integer
+
+      def initialize: (
+        domain: String,
+        ?max_products: Integer,
+        ?timeout_ms: Integer,
+        ?request_options: BrandDev::request_opts
+      ) -> void
+
+      def to_hash: -> {
+        domain: String,
+        max_products: Integer,
+        timeout_ms: Integer,
+        request_options: BrandDev::RequestOptions
+      }
+    end
+  end
+end

data/sig/brand_dev/models/brand_ai_products_response.rbs

@@ -0,0 +1,121 @@
+module BrandDev
+  module Models
+    type brand_ai_products_response =
+      { products: ::Array[BrandDev::Models::BrandAIProductsResponse::Product] }
+
+    class BrandAIProductsResponse < BrandDev::Internal::Type::BaseModel
+      attr_reader products: ::Array[BrandDev::Models::BrandAIProductsResponse::Product]?
+
+      def products=: (
+        ::Array[BrandDev::Models::BrandAIProductsResponse::Product]
+      ) -> ::Array[BrandDev::Models::BrandAIProductsResponse::Product]
+
+      def initialize: (
+        ?products: ::Array[BrandDev::Models::BrandAIProductsResponse::Product]
+      ) -> void
+
+      def to_hash: -> {
+        products: ::Array[BrandDev::Models::BrandAIProductsResponse::Product]
+      }
+
+      type product =
+        {
+          description: String,
+          features: ::Array[String],
+          name: String,
+          tags: ::Array[String],
+          target_audience: ::Array[String],
+          billing_frequency: BrandDev::Models::BrandAIProductsResponse::Product::billing_frequency?,
+          category: String?,
+          currency: String?,
+          image_url: String?,
+          price: Float?,
+          pricing_model: BrandDev::Models::BrandAIProductsResponse::Product::pricing_model?,
+          url: String?
+        }
+
+      class Product < BrandDev::Internal::Type::BaseModel
+        attr_accessor description: String
+
+        attr_accessor features: ::Array[String]
+
+        attr_accessor name: String
+
+        attr_accessor tags: ::Array[String]
+
+        attr_accessor target_audience: ::Array[String]
+
+        attr_accessor billing_frequency: BrandDev::Models::BrandAIProductsResponse::Product::billing_frequency?
+
+        attr_accessor category: String?
+
+        attr_accessor currency: String?
+
+        attr_accessor image_url: String?
+
+        attr_accessor price: Float?
+
+        attr_accessor pricing_model: BrandDev::Models::BrandAIProductsResponse::Product::pricing_model?
+
+        attr_accessor url: String?
+
+        def initialize: (
+          description: String,
+          features: ::Array[String],
+          name: String,
+          tags: ::Array[String],
+          target_audience: ::Array[String],
+          ?billing_frequency: BrandDev::Models::BrandAIProductsResponse::Product::billing_frequency?,
+          ?category: String?,
+          ?currency: String?,
+          ?image_url: String?,
+          ?price: Float?,
+          ?pricing_model: BrandDev::Models::BrandAIProductsResponse::Product::pricing_model?,
+          ?url: String?
+        ) -> void
+
+        def to_hash: -> {
+          description: String,
+          features: ::Array[String],
+          name: String,
+          tags: ::Array[String],
+          target_audience: ::Array[String],
+          billing_frequency: BrandDev::Models::BrandAIProductsResponse::Product::billing_frequency?,
+          category: String?,
+          currency: String?,
+          image_url: String?,
+          price: Float?,
+          pricing_model: BrandDev::Models::BrandAIProductsResponse::Product::pricing_model?,
+          url: String?
+        }
+
+        type billing_frequency = :monthly | :yearly | :one_time | :usage_based
+
+        module BillingFrequency
+          extend BrandDev::Internal::Type::Enum
+
+          MONTHLY: :monthly
+          YEARLY: :yearly
+          ONE_TIME: :one_time
+          USAGE_BASED: :usage_based
+
+          def self?.values: -> ::Array[BrandDev::Models::BrandAIProductsResponse::Product::billing_frequency]
+        end
+
+        type pricing_model = :per_seat | :flat | :tiered | :freemium | :custom
+
+        module PricingModel
+          extend BrandDev::Internal::Type::Enum
+
+          PER_SEAT: :per_seat
+          FLAT: :flat
+          TIERED: :tiered
+          FREEMIUM: :freemium
+          CUSTOM: :custom
+
+          def self?.values: -> ::Array[BrandDev::Models::BrandAIProductsResponse::Product::pricing_model]
+        end
+      end
+    end
+  end
+end

data/sig/brand_dev/models.rbs

@@ -1,4 +1,6 @@
 module BrandDev
+  class BrandAIProductsParams = BrandDev::Models::BrandAIProductsParams
+
   class BrandAIQueryParams = BrandDev::Models::BrandAIQueryParams
 
   class BrandFontsParams = BrandDev::Models::BrandFontsParams

data/sig/brand_dev/resources/brand.rbs

@@ -9,6 +9,13 @@ module BrandDev
         ?request_options: BrandDev::request_opts
       ) -> BrandDev::Models::BrandRetrieveResponse
 
+      def ai_products: (
+        domain: String,
+        ?max_products: Integer,
+        ?timeout_ms: Integer,
+        ?request_options: BrandDev::request_opts
+      ) -> BrandDev::Models::BrandAIProductsResponse
+
       def ai_query: (
         data_to_extract: ::Array[BrandDev::BrandAIQueryParams::DataToExtract],
         domain: String,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: brand.dev
 version: !ruby/object:Gem::Version
-  version: 0.19.0
+  version: 0.20.0
 platform: ruby
 authors:
 - Brand Dev
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-12-22 00:00:00.000000000 Z
+date: 2026-01-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: connection_pool
@@ -54,6 +54,8 @@ files:
 - lib/brand_dev/internal/type/unknown.rb
 - lib/brand_dev/internal/util.rb
 - lib/brand_dev/models.rb
+- lib/brand_dev/models/brand_ai_products_params.rb
+- lib/brand_dev/models/brand_ai_products_response.rb
 - lib/brand_dev/models/brand_ai_query_params.rb
 - lib/brand_dev/models/brand_ai_query_response.rb
 - lib/brand_dev/models/brand_fonts_params.rb
@@ -105,6 +107,8 @@ files:
 - rbi/brand_dev/internal/type/unknown.rbi
 - rbi/brand_dev/internal/util.rbi
 - rbi/brand_dev/models.rbi
+- rbi/brand_dev/models/brand_ai_products_params.rbi
+- rbi/brand_dev/models/brand_ai_products_response.rbi
 - rbi/brand_dev/models/brand_ai_query_params.rbi
 - rbi/brand_dev/models/brand_ai_query_response.rbi
 - rbi/brand_dev/models/brand_fonts_params.rbi
@@ -155,6 +159,8 @@ files:
 - sig/brand_dev/internal/type/unknown.rbs
 - sig/brand_dev/internal/util.rbs
 - sig/brand_dev/models.rbs
+- sig/brand_dev/models/brand_ai_products_params.rbs
+- sig/brand_dev/models/brand_ai_products_response.rbs
 - sig/brand_dev/models/brand_ai_query_params.rbs
 - sig/brand_dev/models/brand_ai_query_response.rbs
 - sig/brand_dev/models/brand_fonts_params.rbs