brand.dev 0.23.0 → 0.25.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4d62936819f843f3b39b44d3e7ee2dcdb37d8bab316c6dff544032989d4c579e
-  data.tar.gz: 0f5406cd25c0db18f69e9b41687c83582274a5aa6954fd776143b3cf2e127707
+  metadata.gz: 586503b2436acd1a836fdd867ebaf4258c5cb928320defd1b62b70c712439bc8
+  data.tar.gz: 3adcd4f046fd0a5d7ee98a6ee2367191e1925a3549a0a8a4b779d876d1c2fe72
 SHA512:
-  metadata.gz: f90ff68d81d283086db18cdc24be921b97f2fb753049a716599a2a2b908537c45d88fbac9e9909b7824a28557fc34954e41acb4cef8edae0c140033fcc4c266b
-  data.tar.gz: 40607397b880852fc184119bae74815d997a88c30d9d07b420ad0e4171e272b4a4f177dcaa2106e4b55cf446ee6a14e804406ecea613ef66b940f1565aa53b29
+  metadata.gz: 96a199073279aa10b42f908a1fc3705290eebb271559fd8249bfdb2d8cd157dbd32fdb177381139ebed4bc2b6154f6e1b251c6e4278f6f19091c0321d3408063
+  data.tar.gz: cb915b6992b9ab682c0a0ebec5b11d7245f18c18e23fbf649bd19595157733f99e5d68763b37e2443572fa9911fe32d4f406d3a72e173035a7342a17aafc56ac

data/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## 0.25.0 (2026-02-22)
+
+Full Changelog: [v0.24.0...v0.25.0](https://github.com/brand-dot-dev/ruby-sdk/compare/v0.24.0...v0.25.0)
+
+### Features
+
+* **api:** api update ([a8001da](https://github.com/brand-dot-dev/ruby-sdk/commit/a8001da388a5bf764a6fe19b7df7bc3572ae3dce))
+
+
+### Chores
+
+* **internal:** remove mock server code ([106d37c](https://github.com/brand-dot-dev/ruby-sdk/commit/106d37c53f7459910a897b4f675b97a003b73f7c))
+* update mock server docs ([e60e130](https://github.com/brand-dot-dev/ruby-sdk/commit/e60e13027cec2ae0282f1ca4c4785d3586efe304))
+
+## 0.24.0 (2026-02-09)
+
+Full Changelog: [v0.23.0...v0.24.0](https://github.com/brand-dot-dev/ruby-sdk/compare/v0.23.0...v0.24.0)
+
+### Features
+
+* **api:** manual updates ([d51dcea](https://github.com/brand-dot-dev/ruby-sdk/commit/d51dcea705ad031b9010a391b7ed3a26c115beab))
+
 ## 0.23.0 (2026-02-07)
 
 Full Changelog: [v0.22.0...v0.23.0](https://github.com/brand-dot-dev/ruby-sdk/compare/v0.22.0...v0.23.0)

data/README.md

@@ -26,7 +26,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.23.0"
+gem "brand.dev", "~> 0.25.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/brand_dev/models/brand_ai_product_params.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module BrandDev
+  module Models
+    # @see BrandDev::Resources::Brand#ai_product
+    class BrandAIProductParams < BrandDev::Internal::Type::BaseModel
+      extend BrandDev::Internal::Type::RequestParameters::Converter
+      include BrandDev::Internal::Type::RequestParameters
+
+      # @!attribute url
+      #   The product page URL to extract product data from.
+      #
+      #   @return [String]
+      required :url, String
+
+      # @!attribute timeout_ms
+      #   Optional timeout in milliseconds for the request. Maximum allowed value is
+      #   300000ms (5 minutes).
+      #
+      #   @return [Integer, nil]
+      optional :timeout_ms, Integer, api_name: :timeoutMS
+
+      # @!method initialize(url:, timeout_ms: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {BrandDev::Models::BrandAIProductParams} for more details.
+      #
+      #   @param url [String] The product page URL to extract product data from.
+      #
+      #   @param timeout_ms [Integer] Optional timeout in milliseconds for the request. Maximum allowed value is 30000
+      #
+      #   @param request_options [BrandDev::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/brand_dev/models/brand_ai_product_response.rb

@@ -0,0 +1,193 @@
+# frozen_string_literal: true
+
+module BrandDev
+  module Models
+    # @see BrandDev::Resources::Brand#ai_product
+    class BrandAIProductResponse < BrandDev::Internal::Type::BaseModel
+      # @!attribute is_product_page
+      #   Whether the given URL is a product detail page
+      #
+      #   @return [Boolean, nil]
+      optional :is_product_page, BrandDev::Internal::Type::Boolean
+
+      # @!attribute platform
+      #   The detected ecommerce platform, or null if not a product page
+      #
+      #   @return [Symbol, BrandDev::Models::BrandAIProductResponse::Platform, nil]
+      optional :platform, enum: -> { BrandDev::Models::BrandAIProductResponse::Platform }, nil?: true
+
+      # @!attribute product
+      #   The extracted product data, or null if not a product page
+      #
+      #   @return [BrandDev::Models::BrandAIProductResponse::Product, nil]
+      optional :product, -> { BrandDev::Models::BrandAIProductResponse::Product }, nil?: true
+
+      # @!method initialize(is_product_page: nil, platform: nil, product: nil)
+      #   @param is_product_page [Boolean] Whether the given URL is a product detail page
+      #
+      #   @param platform [Symbol, BrandDev::Models::BrandAIProductResponse::Platform, nil] The detected ecommerce platform, or null if not a product page
+      #
+      #   @param product [BrandDev::Models::BrandAIProductResponse::Product, nil] The extracted product data, or null if not a product page
+
+      # The detected ecommerce platform, or null if not a product page
+      #
+      # @see BrandDev::Models::BrandAIProductResponse#platform
+      module Platform
+        extend BrandDev::Internal::Type::Enum
+
+        AMAZON = :amazon
+        TIKTOK_SHOP = :tiktok_shop
+        ETSY = :etsy
+        GENERIC = :generic
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+
+      # @see BrandDev::Models::BrandAIProductResponse#product
+      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 images
+        #   URLs to product images on the page (up to 7)
+        #
+        #   @return [Array<String>]
+        required :images, 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::BrandAIProductResponse::Product::BillingFrequency, nil]
+        optional :billing_frequency,
+                 enum: -> { BrandDev::Models::BrandAIProductResponse::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::BrandAIProductResponse::Product::PricingModel, nil]
+        optional :pricing_model,
+                 enum: -> { BrandDev::Models::BrandAIProductResponse::Product::PricingModel },
+                 nil?: true
+
+        # @!attribute url
+        #   URL to the product page
+        #
+        #   @return [String, nil]
+        optional :url, String, nil?: true
+
+        # @!method initialize(description:, features:, images:, name:, tags:, target_audience:, billing_frequency: nil, category: nil, currency: nil, image_url: nil, price: nil, pricing_model: nil, url: nil)
+        #   The extracted product data, or null if not a product page
+        #
+        #   @param description [String] Description of the product
+        #
+        #   @param features [Array<String>] List of product features
+        #
+        #   @param images [Array<String>] URLs to product images on the page (up to 7)
+        #
+        #   @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::BrandAIProductResponse::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::BrandAIProductResponse::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::BrandAIProductResponse::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::BrandAIProductResponse::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/brand_ai_products_response.rb

@@ -27,6 +27,12 @@ module BrandDev
         #   @return [Array<String>]
         required :features, BrandDev::Internal::Type::ArrayOf[String]
 
+        # @!attribute images
+        #   URLs to product images on the page (up to 7)
+        #
+        #   @return [Array<String>]
+        required :images, BrandDev::Internal::Type::ArrayOf[String]
+
         # @!attribute name
         #   Name of the product
         #
@@ -91,11 +97,13 @@ module BrandDev
         #   @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)
+        # @!method initialize(description:, features:, images:, 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 images [Array<String>] URLs to product images on the page (up to 7)
+        #
         #   @param name [String] Name of the product
         #
         #   @param tags [Array<String>] Tags associated with the product

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
 
+  BrandAIProductParams = BrandDev::Models::BrandAIProductParams
+
   BrandAIProductsParams = BrandDev::Models::BrandAIProductsParams
 
   BrandAIQueryParams = BrandDev::Models::BrandAIQueryParams

data/lib/brand_dev/resources/brand.rb

@@ -35,6 +35,35 @@ module BrandDev
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {BrandDev::Models::BrandAIProductParams} for more details.
+      #
+      # Beta feature: Given a single URL, determines if it is a product detail page,
+      # classifies the platform/product type, and extracts the product information.
+      # Supports Amazon, TikTok Shop, Etsy, and generic ecommerce sites.
+      #
+      # @overload ai_product(url:, timeout_ms: nil, request_options: {})
+      #
+      # @param url [String] The product page URL to extract product data from.
+      #
+      # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. Maximum allowed value is 30000
+      #
+      # @param request_options [BrandDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [BrandDev::Models::BrandAIProductResponse]
+      #
+      # @see BrandDev::Models::BrandAIProductParams
+      def ai_product(params)
+        parsed, options = BrandDev::BrandAIProductParams.dump_request(params)
+        @client.request(
+          method: :post,
+          path: "brand/ai/product",
+          body: parsed,
+          model: BrandDev::Models::BrandAIProductResponse,
+          options: options
+        )
+      end
+
       # Some parameter documentations has been truncated, see
       # {BrandDev::Models::BrandAIProductsParams} for more details.
       #

data/lib/brand_dev/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BrandDev
-  VERSION = "0.23.0"
+  VERSION = "0.25.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_product_params"
+require_relative "brand_dev/models/brand_ai_product_response"
 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"

data/rbi/brand_dev/models/brand_ai_product_params.rbi

@@ -0,0 +1,56 @@
+# typed: strong
+
+module BrandDev
+  module Models
+    class BrandAIProductParams < BrandDev::Internal::Type::BaseModel
+      extend BrandDev::Internal::Type::RequestParameters::Converter
+      include BrandDev::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(BrandDev::BrandAIProductParams, BrandDev::Internal::AnyHash)
+        end
+
+      # The product page URL to extract product data from.
+      sig { returns(String) }
+      attr_accessor :url
+
+      # Optional timeout in milliseconds for the request. 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(
+          url: String,
+          timeout_ms: Integer,
+          request_options: BrandDev::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The product page URL to extract product data from.
+        url:,
+        # Optional timeout in milliseconds for the request. Maximum allowed value is
+        # 300000ms (5 minutes).
+        timeout_ms: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            url: String,
+            timeout_ms: Integer,
+            request_options: BrandDev::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/brand_dev/models/brand_ai_product_response.rbi

@@ -0,0 +1,376 @@
+# typed: strong
+
+module BrandDev
+  module Models
+    class BrandAIProductResponse < BrandDev::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            BrandDev::Models::BrandAIProductResponse,
+            BrandDev::Internal::AnyHash
+          )
+        end
+
+      # Whether the given URL is a product detail page
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :is_product_page
+
+      sig { params(is_product_page: T::Boolean).void }
+      attr_writer :is_product_page
+
+      # The detected ecommerce platform, or null if not a product page
+      sig do
+        returns(
+          T.nilable(
+            BrandDev::Models::BrandAIProductResponse::Platform::TaggedSymbol
+          )
+        )
+      end
+      attr_accessor :platform
+
+      # The extracted product data, or null if not a product page
+      sig do
+        returns(T.nilable(BrandDev::Models::BrandAIProductResponse::Product))
+      end
+      attr_reader :product
+
+      sig do
+        params(
+          product:
+            T.nilable(BrandDev::Models::BrandAIProductResponse::Product::OrHash)
+        ).void
+      end
+      attr_writer :product
+
+      sig do
+        params(
+          is_product_page: T::Boolean,
+          platform:
+            T.nilable(
+              BrandDev::Models::BrandAIProductResponse::Platform::OrSymbol
+            ),
+          product:
+            T.nilable(BrandDev::Models::BrandAIProductResponse::Product::OrHash)
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Whether the given URL is a product detail page
+        is_product_page: nil,
+        # The detected ecommerce platform, or null if not a product page
+        platform: nil,
+        # The extracted product data, or null if not a product page
+        product: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            is_product_page: T::Boolean,
+            platform:
+              T.nilable(
+                BrandDev::Models::BrandAIProductResponse::Platform::TaggedSymbol
+              ),
+            product:
+              T.nilable(BrandDev::Models::BrandAIProductResponse::Product)
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # The detected ecommerce platform, or null if not a product page
+      module Platform
+        extend BrandDev::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, BrandDev::Models::BrandAIProductResponse::Platform)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        AMAZON =
+          T.let(
+            :amazon,
+            BrandDev::Models::BrandAIProductResponse::Platform::TaggedSymbol
+          )
+        TIKTOK_SHOP =
+          T.let(
+            :tiktok_shop,
+            BrandDev::Models::BrandAIProductResponse::Platform::TaggedSymbol
+          )
+        ETSY =
+          T.let(
+            :etsy,
+            BrandDev::Models::BrandAIProductResponse::Platform::TaggedSymbol
+          )
+        GENERIC =
+          T.let(
+            :generic,
+            BrandDev::Models::BrandAIProductResponse::Platform::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              BrandDev::Models::BrandAIProductResponse::Platform::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+
+      class Product < BrandDev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              BrandDev::Models::BrandAIProductResponse::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
+
+        # URLs to product images on the page (up to 7)
+        sig { returns(T::Array[String]) }
+        attr_accessor :images
+
+        # 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::BrandAIProductResponse::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::BrandAIProductResponse::Product::PricingModel::TaggedSymbol
+            )
+          )
+        end
+        attr_accessor :pricing_model
+
+        # URL to the product page
+        sig { returns(T.nilable(String)) }
+        attr_accessor :url
+
+        # The extracted product data, or null if not a product page
+        sig do
+          params(
+            description: String,
+            features: T::Array[String],
+            images: T::Array[String],
+            name: String,
+            tags: T::Array[String],
+            target_audience: T::Array[String],
+            billing_frequency:
+              T.nilable(
+                BrandDev::Models::BrandAIProductResponse::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::BrandAIProductResponse::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:,
+          # URLs to product images on the page (up to 7)
+          images:,
+          # 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],
+              images: T::Array[String],
+              name: String,
+              tags: T::Array[String],
+              target_audience: T::Array[String],
+              billing_frequency:
+                T.nilable(
+                  BrandDev::Models::BrandAIProductResponse::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::BrandAIProductResponse::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::BrandAIProductResponse::Product::BillingFrequency
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          MONTHLY =
+            T.let(
+              :monthly,
+              BrandDev::Models::BrandAIProductResponse::Product::BillingFrequency::TaggedSymbol
+            )
+          YEARLY =
+            T.let(
+              :yearly,
+              BrandDev::Models::BrandAIProductResponse::Product::BillingFrequency::TaggedSymbol
+            )
+          ONE_TIME =
+            T.let(
+              :one_time,
+              BrandDev::Models::BrandAIProductResponse::Product::BillingFrequency::TaggedSymbol
+            )
+          USAGE_BASED =
+            T.let(
+              :usage_based,
+              BrandDev::Models::BrandAIProductResponse::Product::BillingFrequency::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                BrandDev::Models::BrandAIProductResponse::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::BrandAIProductResponse::Product::PricingModel
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          PER_SEAT =
+            T.let(
+              :per_seat,
+              BrandDev::Models::BrandAIProductResponse::Product::PricingModel::TaggedSymbol
+            )
+          FLAT =
+            T.let(
+              :flat,
+              BrandDev::Models::BrandAIProductResponse::Product::PricingModel::TaggedSymbol
+            )
+          TIERED =
+            T.let(
+              :tiered,
+              BrandDev::Models::BrandAIProductResponse::Product::PricingModel::TaggedSymbol
+            )
+          FREEMIUM =
+            T.let(
+              :freemium,
+              BrandDev::Models::BrandAIProductResponse::Product::PricingModel::TaggedSymbol
+            )
+          CUSTOM =
+            T.let(
+              :custom,
+              BrandDev::Models::BrandAIProductResponse::Product::PricingModel::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                BrandDev::Models::BrandAIProductResponse::Product::PricingModel::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+      end
+    end
+  end
+end

data/rbi/brand_dev/models/brand_ai_products_response.rbi

@@ -69,6 +69,10 @@ module BrandDev
         sig { returns(T::Array[String]) }
         attr_accessor :features
 
+        # URLs to product images on the page (up to 7)
+        sig { returns(T::Array[String]) }
+        attr_accessor :images
+
         # Name of the product
         sig { returns(String) }
         attr_accessor :name
@@ -125,6 +129,7 @@ module BrandDev
           params(
             description: String,
             features: T::Array[String],
+            images: T::Array[String],
             name: String,
             tags: T::Array[String],
             target_audience: T::Array[String],
@@ -148,6 +153,8 @@ module BrandDev
           description:,
           # List of product features
           features:,
+          # URLs to product images on the page (up to 7)
+          images:,
           # Name of the product
           name:,
           # Tags associated with the product
@@ -176,6 +183,7 @@ module BrandDev
             {
               description: String,
               features: T::Array[String],
+              images: T::Array[String],
               name: String,
               tags: T::Array[String],
               target_audience: T::Array[String],

data/rbi/brand_dev/models.rbi

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

data/rbi/brand_dev/resources/brand.rbi

@@ -34,6 +34,26 @@ module BrandDev
       )
       end
 
+      # Beta feature: Given a single URL, determines if it is a product detail page,
+      # classifies the platform/product type, and extracts the product information.
+      # Supports Amazon, TikTok Shop, Etsy, and generic ecommerce sites.
+      sig do
+        params(
+          url: String,
+          timeout_ms: Integer,
+          request_options: BrandDev::RequestOptions::OrHash
+        ).returns(BrandDev::Models::BrandAIProductResponse)
+      end
+      def ai_product(
+        # The product page URL to extract product data from.
+        url:,
+        # Optional timeout in milliseconds for the request. Maximum allowed value is
+        # 300000ms (5 minutes).
+        timeout_ms: nil,
+        request_options: {}
+      )
+      end
+
       # 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.

data/sig/brand_dev/models/brand_ai_product_params.rbs

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

data/sig/brand_dev/models/brand_ai_product_response.rbs

@@ -0,0 +1,149 @@
+module BrandDev
+  module Models
+    type brand_ai_product_response =
+      {
+        is_product_page: bool,
+        platform: BrandDev::Models::BrandAIProductResponse::platform?,
+        product: BrandDev::Models::BrandAIProductResponse::Product?
+      }
+
+    class BrandAIProductResponse < BrandDev::Internal::Type::BaseModel
+      attr_reader is_product_page: bool?
+
+      def is_product_page=: (bool) -> bool
+
+      attr_accessor platform: BrandDev::Models::BrandAIProductResponse::platform?
+
+      attr_accessor product: BrandDev::Models::BrandAIProductResponse::Product?
+
+      def initialize: (
+        ?is_product_page: bool,
+        ?platform: BrandDev::Models::BrandAIProductResponse::platform?,
+        ?product: BrandDev::Models::BrandAIProductResponse::Product?
+      ) -> void
+
+      def to_hash: -> {
+        is_product_page: bool,
+        platform: BrandDev::Models::BrandAIProductResponse::platform?,
+        product: BrandDev::Models::BrandAIProductResponse::Product?
+      }
+
+      type platform = :amazon | :tiktok_shop | :etsy | :generic
+
+      module Platform
+        extend BrandDev::Internal::Type::Enum
+
+        AMAZON: :amazon
+        TIKTOK_SHOP: :tiktok_shop
+        ETSY: :etsy
+        GENERIC: :generic
+
+        def self?.values: -> ::Array[BrandDev::Models::BrandAIProductResponse::platform]
+      end
+
+      type product =
+        {
+          description: String,
+          features: ::Array[String],
+          images: ::Array[String],
+          name: String,
+          tags: ::Array[String],
+          target_audience: ::Array[String],
+          billing_frequency: BrandDev::Models::BrandAIProductResponse::Product::billing_frequency?,
+          category: String?,
+          currency: String?,
+          image_url: String?,
+          price: Float?,
+          pricing_model: BrandDev::Models::BrandAIProductResponse::Product::pricing_model?,
+          url: String?
+        }
+
+      class Product < BrandDev::Internal::Type::BaseModel
+        attr_accessor description: String
+
+        attr_accessor features: ::Array[String]
+
+        attr_accessor images: ::Array[String]
+
+        attr_accessor name: String
+
+        attr_accessor tags: ::Array[String]
+
+        attr_accessor target_audience: ::Array[String]
+
+        attr_accessor billing_frequency: BrandDev::Models::BrandAIProductResponse::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::BrandAIProductResponse::Product::pricing_model?
+
+        attr_accessor url: String?
+
+        def initialize: (
+          description: String,
+          features: ::Array[String],
+          images: ::Array[String],
+          name: String,
+          tags: ::Array[String],
+          target_audience: ::Array[String],
+          ?billing_frequency: BrandDev::Models::BrandAIProductResponse::Product::billing_frequency?,
+          ?category: String?,
+          ?currency: String?,
+          ?image_url: String?,
+          ?price: Float?,
+          ?pricing_model: BrandDev::Models::BrandAIProductResponse::Product::pricing_model?,
+          ?url: String?
+        ) -> void
+
+        def to_hash: -> {
+          description: String,
+          features: ::Array[String],
+          images: ::Array[String],
+          name: String,
+          tags: ::Array[String],
+          target_audience: ::Array[String],
+          billing_frequency: BrandDev::Models::BrandAIProductResponse::Product::billing_frequency?,
+          category: String?,
+          currency: String?,
+          image_url: String?,
+          price: Float?,
+          pricing_model: BrandDev::Models::BrandAIProductResponse::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::BrandAIProductResponse::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::BrandAIProductResponse::Product::pricing_model]
+        end
+      end
+    end
+  end
+end

data/sig/brand_dev/models/brand_ai_products_response.rbs

@@ -22,6 +22,7 @@ module BrandDev
         {
           description: String,
           features: ::Array[String],
+          images: ::Array[String],
           name: String,
           tags: ::Array[String],
           target_audience: ::Array[String],
@@ -39,6 +40,8 @@ module BrandDev
 
         attr_accessor features: ::Array[String]
 
+        attr_accessor images: ::Array[String]
+
         attr_accessor name: String
 
         attr_accessor tags: ::Array[String]
@@ -62,6 +65,7 @@ module BrandDev
         def initialize: (
           description: String,
           features: ::Array[String],
+          images: ::Array[String],
           name: String,
           tags: ::Array[String],
           target_audience: ::Array[String],
@@ -77,6 +81,7 @@ module BrandDev
         def to_hash: -> {
           description: String,
           features: ::Array[String],
+          images: ::Array[String],
           name: String,
           tags: ::Array[String],
           target_audience: ::Array[String],

data/sig/brand_dev/models.rbs

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

data/sig/brand_dev/resources/brand.rbs

@@ -9,6 +9,12 @@ module BrandDev
         ?request_options: BrandDev::request_opts
       ) -> BrandDev::Models::BrandRetrieveResponse
 
+      def ai_product: (
+        url: String,
+        ?timeout_ms: Integer,
+        ?request_options: BrandDev::request_opts
+      ) -> BrandDev::Models::BrandAIProductResponse
+
       def ai_products: (
         domain: String,
         direct_url: String,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: brand.dev
 version: !ruby/object:Gem::Version
-  version: 0.23.0
+  version: 0.25.0
 platform: ruby
 authors:
 - Brand Dev
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-07 00:00:00.000000000 Z
+date: 2026-02-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -68,6 +68,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_product_params.rb
+- lib/brand_dev/models/brand_ai_product_response.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
@@ -121,6 +123,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_product_params.rbi
+- rbi/brand_dev/models/brand_ai_product_response.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
@@ -173,6 +177,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_product_params.rbs
+- sig/brand_dev/models/brand_ai_product_response.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