brand.dev 0.14.0 → 0.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fda4fc2056b5d95165ea2382b716c6289a31530ac84e95ad5184882c77c8b16c
-  data.tar.gz: 446f5ace123e360e235d06acf5f0b0ff012f0b233993afa9bbaba89850bf4707
+  metadata.gz: ccf8dd90507c84dcea927392291711080cc1dff713f6033bb87f974573f66417
+  data.tar.gz: dab13e3371525060dcf6a098cc9d75faba070512dd62aca367addff096cfab1f
 SHA512:
-  metadata.gz: d4dc5e7f463794528ebb79f2bab854dd169ed4088343568c7c6332c987b4544d9743580aa75c3936159723df6087848de2c3b9d2b8584079d13a684c09492aac
-  data.tar.gz: 8807c59f396a4e6a1e9217dba3c8fcdddc85497917b762a6ed9fc2ece4ba721885cf9f6c8e280aade89c3d5ad4e6fe75bf1df5cc9045843813e6eb9f585203f3
+  metadata.gz: 48199f00792a5f903f0ebb82179675614a0e3f0a68e75b7e03adc7f26cb061b4a44f704b4afcfa6400caf5c539b62c10e2b89120740d3faf661a7e57fe3525db
+  data.tar.gz: ad14e379feafc54eb6989a0fb16c9b37d1eb29424566344f6b0c442921eeafbaf92826d7a5ef5e3f5e4c5acd04749c4700de34be20336965c3d9653671ebb36f

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.16.0 (2025-12-01)
+
+Full Changelog: [v0.15.0...v0.16.0](https://github.com/brand-dot-dev/ruby-sdk/compare/v0.15.0...v0.16.0)
+
+### Features
+
+* **api:** api update ([dcb86fa](https://github.com/brand-dot-dev/ruby-sdk/commit/dcb86fa97e3a08822e0a379989adbf766b7638c2))
+
+## 0.15.0 (2025-11-29)
+
+Full Changelog: [v0.14.0...v0.15.0](https://github.com/brand-dot-dev/ruby-sdk/compare/v0.14.0...v0.15.0)
+
+### Features
+
+* **api:** manual updates ([1586ca9](https://github.com/brand-dot-dev/ruby-sdk/commit/1586ca9407bc0c7821563fb93b640c1e7308528d))
+
 ## 0.14.0 (2025-11-24)
 
 Full Changelog: [v0.13.0...v0.14.0](https://github.com/brand-dot-dev/ruby-sdk/compare/v0.13.0...v0.14.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.14.0"
+gem "brand.dev", "~> 0.16.0"
 ```
 
 <!-- x-release-please-end -->

data/lib/brand_dev/models/brand_ai_query_params.rb

@@ -73,7 +73,25 @@ module BrandDev
         #   @return [Symbol, BrandDev::Models::BrandAIQueryParams::DataToExtract::DatapointType]
         required :datapoint_type, enum: -> { BrandDev::BrandAIQueryParams::DataToExtract::DatapointType }
 
-        # @!method initialize(datapoint_description:, datapoint_example:, datapoint_name:, datapoint_type:)
+        # @!attribute datapoint_list_type
+        #   Type of items in the list when datapoint_type is 'list'. Defaults to 'string'.
+        #   Use 'object' to extract an array of objects matching a schema.
+        #
+        #   @return [Symbol, BrandDev::Models::BrandAIQueryParams::DataToExtract::DatapointListType, nil]
+        optional :datapoint_list_type, enum: -> { BrandDev::BrandAIQueryParams::DataToExtract::DatapointListType }
+
+        # @!attribute datapoint_object_schema
+        #   Schema definition for objects when datapoint_list_type is 'object'. Provide a
+        #   map of field names to their scalar types.
+        #
+        #   @return [Hash{Symbol=>Symbol, BrandDev::Models::BrandAIQueryParams::DataToExtract::DatapointObjectSchema}, nil]
+        optional :datapoint_object_schema,
+                 -> { BrandDev::Internal::Type::HashOf[enum: BrandDev::BrandAIQueryParams::DataToExtract::DatapointObjectSchema] }
+
+        # @!method initialize(datapoint_description:, datapoint_example:, datapoint_name:, datapoint_type:, datapoint_list_type: nil, datapoint_object_schema: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {BrandDev::Models::BrandAIQueryParams::DataToExtract} for more details.
+        #
         #   @param datapoint_description [String] Description of what to extract
         #
         #   @param datapoint_example [String] Example of the expected value
@@ -81,6 +99,10 @@ module BrandDev
         #   @param datapoint_name [String] Name of the data point to extract
         #
         #   @param datapoint_type [Symbol, BrandDev::Models::BrandAIQueryParams::DataToExtract::DatapointType] Type of the data point
+        #
+        #   @param datapoint_list_type [Symbol, BrandDev::Models::BrandAIQueryParams::DataToExtract::DatapointListType] Type of items in the list when datapoint_type is 'list'. Defaults to 'string'. U
+        #
+        #   @param datapoint_object_schema [Hash{Symbol=>Symbol, BrandDev::Models::BrandAIQueryParams::DataToExtract::DatapointObjectSchema}] Schema definition for objects when datapoint_list_type is 'object'. Provide a ma
 
         # Type of the data point
         #
@@ -98,6 +120,38 @@ module BrandDev
           # @!method self.values
           #   @return [Array<Symbol>]
         end
+
+        # Type of items in the list when datapoint_type is 'list'. Defaults to 'string'.
+        # Use 'object' to extract an array of objects matching a schema.
+        #
+        # @see BrandDev::Models::BrandAIQueryParams::DataToExtract#datapoint_list_type
+        module DatapointListType
+          extend BrandDev::Internal::Type::Enum
+
+          STRING = :string
+          TEXT = :text
+          NUMBER = :number
+          DATE = :date
+          BOOLEAN = :boolean
+          LIST = :list
+          URL = :url
+          OBJECT = :object
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        module DatapointObjectSchema
+          extend BrandDev::Internal::Type::Enum
+
+          STRING = :string
+          NUMBER = :number
+          DATE = :date
+          BOOLEAN = :boolean
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
       end
 
       class SpecificPages < BrandDev::Internal::Type::BaseModel
@@ -137,6 +191,12 @@ module BrandDev
         #   @return [Boolean, nil]
         optional :home_page, BrandDev::Internal::Type::Boolean
 
+        # @!attribute pricing
+        #   Whether to analyze the pricing page
+        #
+        #   @return [Boolean, nil]
+        optional :pricing, BrandDev::Internal::Type::Boolean
+
         # @!attribute privacy_policy
         #   Whether to analyze the privacy policy page
         #
@@ -149,7 +209,7 @@ module BrandDev
         #   @return [Boolean, nil]
         optional :terms_and_conditions, BrandDev::Internal::Type::Boolean
 
-        # @!method initialize(about_us: nil, blog: nil, careers: nil, contact_us: nil, faq: nil, home_page: nil, privacy_policy: nil, terms_and_conditions: nil)
+        # @!method initialize(about_us: nil, blog: nil, careers: nil, contact_us: nil, faq: nil, home_page: nil, pricing: nil, privacy_policy: nil, terms_and_conditions: nil)
         #   Optional object specifying which pages to analyze
         #
         #   @param about_us [Boolean] Whether to analyze the about us page
@@ -164,6 +224,8 @@ module BrandDev
         #
         #   @param home_page [Boolean] Whether to analyze the home page
         #
+        #   @param pricing [Boolean] Whether to analyze the pricing page
+        #
         #   @param privacy_policy [Boolean] Whether to analyze the privacy policy page
         #
         #   @param terms_and_conditions [Boolean] Whether to analyze the terms and conditions page

data/lib/brand_dev/models/brand_ai_query_response.rb

@@ -46,18 +46,23 @@ module BrandDev
         optional :datapoint_name, String
 
         # @!attribute datapoint_value
-        #   Value of the extracted data point
+        #   Value of the extracted data point. Can be a primitive type, an array of
+        #   primitives, or an array of objects when datapoint_list_type is 'object'.
         #
-        #   @return [String, Float, Boolean, Array<String>, Array<Float>, nil]
+        #   @return [String, Float, Boolean, Array<String>, Array<Float>, Array<Object>, nil]
         optional :datapoint_value,
                  union: -> { BrandDev::Models::BrandAIQueryResponse::DataExtracted::DatapointValue }
 
         # @!method initialize(datapoint_name: nil, datapoint_value: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {BrandDev::Models::BrandAIQueryResponse::DataExtracted} for more details.
+        #
         #   @param datapoint_name [String] Name of the extracted data point
         #
-        #   @param datapoint_value [String, Float, Boolean, Array<String>, Array<Float>] Value of the extracted data point
+        #   @param datapoint_value [String, Float, Boolean, Array<String>, Array<Float>, Array<Object>] Value of the extracted data point. Can be a primitive type, an array of primitiv
 
-        # Value of the extracted data point
+        # Value of the extracted data point. Can be a primitive type, an array of
+        # primitives, or an array of objects when datapoint_list_type is 'object'.
         #
         # @see BrandDev::Models::BrandAIQueryResponse::DataExtracted#datapoint_value
         module DatapointValue
@@ -73,14 +78,19 @@ module BrandDev
 
           variant -> { BrandDev::Models::BrandAIQueryResponse::DataExtracted::DatapointValue::FloatArray }
 
+          variant -> { BrandDev::Models::BrandAIQueryResponse::DataExtracted::DatapointValue::UnionMember5Array }
+
           # @!method self.variants
-          #   @return [Array(String, Float, Boolean, Array<String>, Array<Float>)]
+          #   @return [Array(String, Float, Boolean, Array<String>, Array<Float>, Array<Object>)]
 
           # @type [BrandDev::Internal::Type::Converter]
           StringArray = BrandDev::Internal::Type::ArrayOf[String]
 
           # @type [BrandDev::Internal::Type::Converter]
           FloatArray = BrandDev::Internal::Type::ArrayOf[Float]
+
+          # @type [BrandDev::Internal::Type::Converter]
+          UnionMember5Array = BrandDev::Internal::Type::ArrayOf[BrandDev::Internal::Type::Unknown]
         end
       end
     end

data/lib/brand_dev/models/brand_fonts_params.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module BrandDev
+  module Models
+    # @see BrandDev::Resources::Brand#fonts
+    class BrandFontsParams < BrandDev::Internal::Type::BaseModel
+      extend BrandDev::Internal::Type::RequestParameters::Converter
+      include BrandDev::Internal::Type::RequestParameters
+
+      # @!attribute domain
+      #   Domain name to extract fonts from (e.g., 'example.com', 'google.com'). The
+      #   domain will be automatically normalized and validated.
+      #
+      #   @return [String]
+      required :domain, String
+
+      # @!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
+
+      # @!method initialize(domain:, timeout_ms: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {BrandDev::Models::BrandFontsParams} for more details.
+      #
+      #   @param domain [String] Domain name to extract fonts from (e.g., 'example.com', 'google.com'). The domai
+      #
+      #   @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_fonts_response.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+module BrandDev
+  module Models
+    # @see BrandDev::Resources::Brand#fonts
+    class BrandFontsResponse < BrandDev::Internal::Type::BaseModel
+      # @!attribute code
+      #   HTTP status code, e.g., 200
+      #
+      #   @return [Integer]
+      required :code, Integer
+
+      # @!attribute domain
+      #   The normalized domain that was processed
+      #
+      #   @return [String]
+      required :domain, String
+
+      # @!attribute fonts
+      #   Array of font usage information
+      #
+      #   @return [Array<BrandDev::Models::BrandFontsResponse::Font>]
+      required :fonts, -> { BrandDev::Internal::Type::ArrayOf[BrandDev::Models::BrandFontsResponse::Font] }
+
+      # @!attribute status
+      #   Status of the response, e.g., 'ok'
+      #
+      #   @return [String]
+      required :status, String
+
+      # @!method initialize(code:, domain:, fonts:, status:)
+      #   @param code [Integer] HTTP status code, e.g., 200
+      #
+      #   @param domain [String] The normalized domain that was processed
+      #
+      #   @param fonts [Array<BrandDev::Models::BrandFontsResponse::Font>] Array of font usage information
+      #
+      #   @param status [String] Status of the response, e.g., 'ok'
+
+      class Font < BrandDev::Internal::Type::BaseModel
+        # @!attribute fallbacks
+        #   Array of fallback font families
+        #
+        #   @return [Array<String>]
+        required :fallbacks, BrandDev::Internal::Type::ArrayOf[String]
+
+        # @!attribute font
+        #   Font family name
+        #
+        #   @return [String]
+        required :font, String
+
+        # @!attribute num_elements
+        #   Number of elements using this font
+        #
+        #   @return [Float]
+        required :num_elements, Float
+
+        # @!attribute num_words
+        #   Number of words using this font
+        #
+        #   @return [Float]
+        required :num_words, Float
+
+        # @!attribute percent_elements
+        #   Percentage of elements using this font
+        #
+        #   @return [Float]
+        required :percent_elements, Float
+
+        # @!attribute percent_words
+        #   Percentage of words using this font
+        #
+        #   @return [Float]
+        required :percent_words, Float
+
+        # @!attribute uses
+        #   Array of CSS selectors or element types where this font is used
+        #
+        #   @return [Array<String>]
+        required :uses, BrandDev::Internal::Type::ArrayOf[String]
+
+        # @!method initialize(fallbacks:, font:, num_elements:, num_words:, percent_elements:, percent_words:, uses:)
+        #   @param fallbacks [Array<String>] Array of fallback font families
+        #
+        #   @param font [String] Font family name
+        #
+        #   @param num_elements [Float] Number of elements using this font
+        #
+        #   @param num_words [Float] Number of words using this font
+        #
+        #   @param percent_elements [Float] Percentage of elements using this font
+        #
+        #   @param percent_words [Float] Percentage of words using this font
+        #
+        #   @param uses [Array<String>] Array of CSS selectors or element types where this font is used
+      end
+    end
+  end
+end

data/lib/brand_dev/models.rb

@@ -41,6 +41,8 @@ module BrandDev
 
   BrandAIQueryParams = BrandDev::Models::BrandAIQueryParams
 
+  BrandFontsParams = BrandDev::Models::BrandFontsParams
+
   BrandIdentifyFromTransactionParams = BrandDev::Models::BrandIdentifyFromTransactionParams
 
   BrandPrefetchParams = BrandDev::Models::BrandPrefetchParams

data/lib/brand_dev/resources/brand.rb

@@ -68,6 +68,34 @@ module BrandDev
         )
       end
 
+      # 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.
+      #
+      # @overload fonts(domain:, timeout_ms: nil, request_options: {})
+      #
+      # @param domain [String] Domain name to extract fonts from (e.g., 'example.com', 'google.com'). The domai
+      #
+      # @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::BrandFontsResponse]
+      #
+      # @see BrandDev::Models::BrandFontsParams
+      def fonts(params)
+        parsed, options = BrandDev::BrandFontsParams.dump_request(params)
+        @client.request(
+          method: :get,
+          path: "brand/fonts",
+          query: parsed.transform_keys(timeout_ms: "timeoutMS"),
+          model: BrandDev::Models::BrandFontsResponse,
+          options: options
+        )
+      end
+
       # Some parameter documentations has been truncated, see
       # {BrandDev::Models::BrandIdentifyFromTransactionParams} for more details.
       #

data/lib/brand_dev/version.rb

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

data/lib/brand_dev.rb

@@ -54,6 +54,8 @@ require_relative "brand_dev/internal/transport/pooled_net_requester"
 require_relative "brand_dev/client"
 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"
+require_relative "brand_dev/models/brand_fonts_response"
 require_relative "brand_dev/models/brand_identify_from_transaction_params"
 require_relative "brand_dev/models/brand_identify_from_transaction_response"
 require_relative "brand_dev/models/brand_prefetch_params"

data/rbi/brand_dev/models/brand_ai_query_params.rbi

@@ -108,13 +108,64 @@ module BrandDev
         end
         attr_accessor :datapoint_type
 
+        # Type of items in the list when datapoint_type is 'list'. Defaults to 'string'.
+        # Use 'object' to extract an array of objects matching a schema.
+        sig do
+          returns(
+            T.nilable(
+              BrandDev::BrandAIQueryParams::DataToExtract::DatapointListType::OrSymbol
+            )
+          )
+        end
+        attr_reader :datapoint_list_type
+
+        sig do
+          params(
+            datapoint_list_type:
+              BrandDev::BrandAIQueryParams::DataToExtract::DatapointListType::OrSymbol
+          ).void
+        end
+        attr_writer :datapoint_list_type
+
+        # Schema definition for objects when datapoint_list_type is 'object'. Provide a
+        # map of field names to their scalar types.
+        sig do
+          returns(
+            T.nilable(
+              T::Hash[
+                Symbol,
+                BrandDev::BrandAIQueryParams::DataToExtract::DatapointObjectSchema::OrSymbol
+              ]
+            )
+          )
+        end
+        attr_reader :datapoint_object_schema
+
+        sig do
+          params(
+            datapoint_object_schema:
+              T::Hash[
+                Symbol,
+                BrandDev::BrandAIQueryParams::DataToExtract::DatapointObjectSchema::OrSymbol
+              ]
+          ).void
+        end
+        attr_writer :datapoint_object_schema
+
         sig do
           params(
             datapoint_description: String,
             datapoint_example: String,
             datapoint_name: String,
             datapoint_type:
-              BrandDev::BrandAIQueryParams::DataToExtract::DatapointType::OrSymbol
+              BrandDev::BrandAIQueryParams::DataToExtract::DatapointType::OrSymbol,
+            datapoint_list_type:
+              BrandDev::BrandAIQueryParams::DataToExtract::DatapointListType::OrSymbol,
+            datapoint_object_schema:
+              T::Hash[
+                Symbol,
+                BrandDev::BrandAIQueryParams::DataToExtract::DatapointObjectSchema::OrSymbol
+              ]
           ).returns(T.attached_class)
         end
         def self.new(
@@ -125,7 +176,13 @@ module BrandDev
           # Name of the data point to extract
           datapoint_name:,
           # Type of the data point
-          datapoint_type:
+          datapoint_type:,
+          # Type of items in the list when datapoint_type is 'list'. Defaults to 'string'.
+          # Use 'object' to extract an array of objects matching a schema.
+          datapoint_list_type: nil,
+          # Schema definition for objects when datapoint_list_type is 'object'. Provide a
+          # map of field names to their scalar types.
+          datapoint_object_schema: nil
         )
         end
 
@@ -136,7 +193,14 @@ module BrandDev
               datapoint_example: String,
               datapoint_name: String,
               datapoint_type:
-                BrandDev::BrandAIQueryParams::DataToExtract::DatapointType::OrSymbol
+                BrandDev::BrandAIQueryParams::DataToExtract::DatapointType::OrSymbol,
+              datapoint_list_type:
+                BrandDev::BrandAIQueryParams::DataToExtract::DatapointListType::OrSymbol,
+              datapoint_object_schema:
+                T::Hash[
+                  Symbol,
+                  BrandDev::BrandAIQueryParams::DataToExtract::DatapointObjectSchema::OrSymbol
+                ]
             }
           )
         end
@@ -197,6 +261,116 @@ module BrandDev
           def self.values
           end
         end
+
+        # Type of items in the list when datapoint_type is 'list'. Defaults to 'string'.
+        # Use 'object' to extract an array of objects matching a schema.
+        module DatapointListType
+          extend BrandDev::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                BrandDev::BrandAIQueryParams::DataToExtract::DatapointListType
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          STRING =
+            T.let(
+              :string,
+              BrandDev::BrandAIQueryParams::DataToExtract::DatapointListType::TaggedSymbol
+            )
+          TEXT =
+            T.let(
+              :text,
+              BrandDev::BrandAIQueryParams::DataToExtract::DatapointListType::TaggedSymbol
+            )
+          NUMBER =
+            T.let(
+              :number,
+              BrandDev::BrandAIQueryParams::DataToExtract::DatapointListType::TaggedSymbol
+            )
+          DATE =
+            T.let(
+              :date,
+              BrandDev::BrandAIQueryParams::DataToExtract::DatapointListType::TaggedSymbol
+            )
+          BOOLEAN =
+            T.let(
+              :boolean,
+              BrandDev::BrandAIQueryParams::DataToExtract::DatapointListType::TaggedSymbol
+            )
+          LIST =
+            T.let(
+              :list,
+              BrandDev::BrandAIQueryParams::DataToExtract::DatapointListType::TaggedSymbol
+            )
+          URL =
+            T.let(
+              :url,
+              BrandDev::BrandAIQueryParams::DataToExtract::DatapointListType::TaggedSymbol
+            )
+          OBJECT =
+            T.let(
+              :object,
+              BrandDev::BrandAIQueryParams::DataToExtract::DatapointListType::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                BrandDev::BrandAIQueryParams::DataToExtract::DatapointListType::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
+
+        module DatapointObjectSchema
+          extend BrandDev::Internal::Type::Enum
+
+          TaggedSymbol =
+            T.type_alias do
+              T.all(
+                Symbol,
+                BrandDev::BrandAIQueryParams::DataToExtract::DatapointObjectSchema
+              )
+            end
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+          STRING =
+            T.let(
+              :string,
+              BrandDev::BrandAIQueryParams::DataToExtract::DatapointObjectSchema::TaggedSymbol
+            )
+          NUMBER =
+            T.let(
+              :number,
+              BrandDev::BrandAIQueryParams::DataToExtract::DatapointObjectSchema::TaggedSymbol
+            )
+          DATE =
+            T.let(
+              :date,
+              BrandDev::BrandAIQueryParams::DataToExtract::DatapointObjectSchema::TaggedSymbol
+            )
+          BOOLEAN =
+            T.let(
+              :boolean,
+              BrandDev::BrandAIQueryParams::DataToExtract::DatapointObjectSchema::TaggedSymbol
+            )
+
+          sig do
+            override.returns(
+              T::Array[
+                BrandDev::BrandAIQueryParams::DataToExtract::DatapointObjectSchema::TaggedSymbol
+              ]
+            )
+          end
+          def self.values
+          end
+        end
       end
 
       class SpecificPages < BrandDev::Internal::Type::BaseModel
@@ -250,6 +424,13 @@ module BrandDev
         sig { params(home_page: T::Boolean).void }
         attr_writer :home_page
 
+        # Whether to analyze the pricing page
+        sig { returns(T.nilable(T::Boolean)) }
+        attr_reader :pricing
+
+        sig { params(pricing: T::Boolean).void }
+        attr_writer :pricing
+
         # Whether to analyze the privacy policy page
         sig { returns(T.nilable(T::Boolean)) }
         attr_reader :privacy_policy
@@ -273,6 +454,7 @@ module BrandDev
             contact_us: T::Boolean,
             faq: T::Boolean,
             home_page: T::Boolean,
+            pricing: T::Boolean,
             privacy_policy: T::Boolean,
             terms_and_conditions: T::Boolean
           ).returns(T.attached_class)
@@ -290,6 +472,8 @@ module BrandDev
           faq: nil,
           # Whether to analyze the home page
           home_page: nil,
+          # Whether to analyze the pricing page
+          pricing: nil,
           # Whether to analyze the privacy policy page
           privacy_policy: nil,
           # Whether to analyze the terms and conditions page
@@ -306,6 +490,7 @@ module BrandDev
               contact_us: T::Boolean,
               faq: T::Boolean,
               home_page: T::Boolean,
+              pricing: T::Boolean,
               privacy_policy: T::Boolean,
               terms_and_conditions: T::Boolean
             }

data/rbi/brand_dev/models/brand_ai_query_response.rbi

@@ -105,7 +105,8 @@ module BrandDev
         sig { params(datapoint_name: String).void }
         attr_writer :datapoint_name
 
-        # Value of the extracted data point
+        # Value of the extracted data point. Can be a primitive type, an array of
+        # primitives, or an array of objects when datapoint_list_type is 'object'.
         sig do
           returns(
             T.nilable(
@@ -133,7 +134,8 @@ module BrandDev
         def self.new(
           # Name of the extracted data point
           datapoint_name: nil,
-          # Value of the extracted data point
+          # Value of the extracted data point. Can be a primitive type, an array of
+          # primitives, or an array of objects when datapoint_list_type is 'object'.
           datapoint_value: nil
         )
         end
@@ -150,7 +152,8 @@ module BrandDev
         def to_hash
         end
 
-        # Value of the extracted data point
+        # Value of the extracted data point. Can be a primitive type, an array of
+        # primitives, or an array of objects when datapoint_list_type is 'object'.
         module DatapointValue
           extend BrandDev::Internal::Type::Union
 
@@ -161,7 +164,8 @@ module BrandDev
                 Float,
                 T::Boolean,
                 T::Array[String],
-                T::Array[Float]
+                T::Array[Float],
+                T::Array[T.anything]
               )
             end
 
@@ -186,6 +190,14 @@ module BrandDev
               BrandDev::Internal::Type::ArrayOf[Float],
               BrandDev::Internal::Type::Converter
             )
+
+          UnionMember5Array =
+            T.let(
+              BrandDev::Internal::Type::ArrayOf[
+                BrandDev::Internal::Type::Unknown
+              ],
+              BrandDev::Internal::Type::Converter
+            )
         end
       end
     end

data/rbi/brand_dev/models/brand_fonts_params.rbi

@@ -0,0 +1,60 @@
+# typed: strong
+
+module BrandDev
+  module Models
+    class BrandFontsParams < BrandDev::Internal::Type::BaseModel
+      extend BrandDev::Internal::Type::RequestParameters::Converter
+      include BrandDev::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(BrandDev::BrandFontsParams, BrandDev::Internal::AnyHash)
+        end
+
+      # Domain name to extract fonts from (e.g., 'example.com', 'google.com'). The
+      # domain will be automatically normalized and validated.
+      sig { returns(String) }
+      attr_accessor :domain
+
+      # 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,
+          timeout_ms: Integer,
+          request_options: BrandDev::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # Domain name to extract fonts from (e.g., 'example.com', 'google.com'). The
+        # domain will be automatically normalized and validated.
+        domain:,
+        # 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,
+            timeout_ms: Integer,
+            request_options: BrandDev::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+    end
+  end
+end

data/rbi/brand_dev/models/brand_fonts_response.rbi

@@ -0,0 +1,147 @@
+# typed: strong
+
+module BrandDev
+  module Models
+    class BrandFontsResponse < BrandDev::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(
+            BrandDev::Models::BrandFontsResponse,
+            BrandDev::Internal::AnyHash
+          )
+        end
+
+      # HTTP status code, e.g., 200
+      sig { returns(Integer) }
+      attr_accessor :code
+
+      # The normalized domain that was processed
+      sig { returns(String) }
+      attr_accessor :domain
+
+      # Array of font usage information
+      sig { returns(T::Array[BrandDev::Models::BrandFontsResponse::Font]) }
+      attr_accessor :fonts
+
+      # Status of the response, e.g., 'ok'
+      sig { returns(String) }
+      attr_accessor :status
+
+      sig do
+        params(
+          code: Integer,
+          domain: String,
+          fonts: T::Array[BrandDev::Models::BrandFontsResponse::Font::OrHash],
+          status: String
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # HTTP status code, e.g., 200
+        code:,
+        # The normalized domain that was processed
+        domain:,
+        # Array of font usage information
+        fonts:,
+        # Status of the response, e.g., 'ok'
+        status:
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            code: Integer,
+            domain: String,
+            fonts: T::Array[BrandDev::Models::BrandFontsResponse::Font],
+            status: String
+          }
+        )
+      end
+      def to_hash
+      end
+
+      class Font < BrandDev::Internal::Type::BaseModel
+        OrHash =
+          T.type_alias do
+            T.any(
+              BrandDev::Models::BrandFontsResponse::Font,
+              BrandDev::Internal::AnyHash
+            )
+          end
+
+        # Array of fallback font families
+        sig { returns(T::Array[String]) }
+        attr_accessor :fallbacks
+
+        # Font family name
+        sig { returns(String) }
+        attr_accessor :font
+
+        # Number of elements using this font
+        sig { returns(Float) }
+        attr_accessor :num_elements
+
+        # Number of words using this font
+        sig { returns(Float) }
+        attr_accessor :num_words
+
+        # Percentage of elements using this font
+        sig { returns(Float) }
+        attr_accessor :percent_elements
+
+        # Percentage of words using this font
+        sig { returns(Float) }
+        attr_accessor :percent_words
+
+        # Array of CSS selectors or element types where this font is used
+        sig { returns(T::Array[String]) }
+        attr_accessor :uses
+
+        sig do
+          params(
+            fallbacks: T::Array[String],
+            font: String,
+            num_elements: Float,
+            num_words: Float,
+            percent_elements: Float,
+            percent_words: Float,
+            uses: T::Array[String]
+          ).returns(T.attached_class)
+        end
+        def self.new(
+          # Array of fallback font families
+          fallbacks:,
+          # Font family name
+          font:,
+          # Number of elements using this font
+          num_elements:,
+          # Number of words using this font
+          num_words:,
+          # Percentage of elements using this font
+          percent_elements:,
+          # Percentage of words using this font
+          percent_words:,
+          # Array of CSS selectors or element types where this font is used
+          uses:
+        )
+        end
+
+        sig do
+          override.returns(
+            {
+              fallbacks: T::Array[String],
+              font: String,
+              num_elements: Float,
+              num_words: Float,
+              percent_elements: Float,
+              percent_words: Float,
+              uses: T::Array[String]
+            }
+          )
+        end
+        def to_hash
+        end
+      end
+    end
+  end
+end

data/rbi/brand_dev/models.rbi

@@ -3,6 +3,8 @@
 module BrandDev
   BrandAIQueryParams = BrandDev::Models::BrandAIQueryParams
 
+  BrandFontsParams = BrandDev::Models::BrandFontsParams
+
   BrandIdentifyFromTransactionParams =
     BrandDev::Models::BrandIdentifyFromTransactionParams
 

data/rbi/brand_dev/resources/brand.rbi

@@ -62,6 +62,27 @@ module BrandDev
       )
       end
 
+      # Beta feature: Extract font information from a brand's website including font
+      # families, usage statistics, fallbacks, and element/word counts.
+      sig do
+        params(
+          domain: String,
+          timeout_ms: Integer,
+          request_options: BrandDev::RequestOptions::OrHash
+        ).returns(BrandDev::Models::BrandFontsResponse)
+      end
+      def fonts(
+        # Domain name to extract fonts from (e.g., 'example.com', 'google.com'). The
+        # domain will be automatically normalized and validated.
+        domain:,
+        # 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
+
       # Endpoint specially designed for platforms that want to identify transaction data
       # by the transaction title.
       sig do

data/sig/brand_dev/models/brand_ai_query_params.rbs

@@ -48,7 +48,9 @@ module BrandDev
           datapoint_description: String,
           datapoint_example: String,
           datapoint_name: String,
-          datapoint_type: BrandDev::Models::BrandAIQueryParams::DataToExtract::datapoint_type
+          datapoint_type: BrandDev::Models::BrandAIQueryParams::DataToExtract::datapoint_type,
+          datapoint_list_type: BrandDev::Models::BrandAIQueryParams::DataToExtract::datapoint_list_type,
+          datapoint_object_schema: ::Hash[Symbol, BrandDev::Models::BrandAIQueryParams::DataToExtract::datapoint_object_schema]
         }
 
       class DataToExtract < BrandDev::Internal::Type::BaseModel
@@ -60,18 +62,34 @@ module BrandDev
 
         attr_accessor datapoint_type: BrandDev::Models::BrandAIQueryParams::DataToExtract::datapoint_type
 
+        attr_reader datapoint_list_type: BrandDev::Models::BrandAIQueryParams::DataToExtract::datapoint_list_type?
+
+        def datapoint_list_type=: (
+          BrandDev::Models::BrandAIQueryParams::DataToExtract::datapoint_list_type
+        ) -> BrandDev::Models::BrandAIQueryParams::DataToExtract::datapoint_list_type
+
+        attr_reader datapoint_object_schema: ::Hash[Symbol, BrandDev::Models::BrandAIQueryParams::DataToExtract::datapoint_object_schema]?
+
+        def datapoint_object_schema=: (
+          ::Hash[Symbol, BrandDev::Models::BrandAIQueryParams::DataToExtract::datapoint_object_schema]
+        ) -> ::Hash[Symbol, BrandDev::Models::BrandAIQueryParams::DataToExtract::datapoint_object_schema]
+
         def initialize: (
           datapoint_description: String,
           datapoint_example: String,
           datapoint_name: String,
-          datapoint_type: BrandDev::Models::BrandAIQueryParams::DataToExtract::datapoint_type
+          datapoint_type: BrandDev::Models::BrandAIQueryParams::DataToExtract::datapoint_type,
+          ?datapoint_list_type: BrandDev::Models::BrandAIQueryParams::DataToExtract::datapoint_list_type,
+          ?datapoint_object_schema: ::Hash[Symbol, BrandDev::Models::BrandAIQueryParams::DataToExtract::datapoint_object_schema]
         ) -> void
 
         def to_hash: -> {
           datapoint_description: String,
           datapoint_example: String,
           datapoint_name: String,
-          datapoint_type: BrandDev::Models::BrandAIQueryParams::DataToExtract::datapoint_type
+          datapoint_type: BrandDev::Models::BrandAIQueryParams::DataToExtract::datapoint_type,
+          datapoint_list_type: BrandDev::Models::BrandAIQueryParams::DataToExtract::datapoint_list_type,
+          datapoint_object_schema: ::Hash[Symbol, BrandDev::Models::BrandAIQueryParams::DataToExtract::datapoint_object_schema]
         }
 
         type datapoint_type = :text | :number | :date | :boolean | :list | :url
@@ -88,6 +106,37 @@ module BrandDev
 
           def self?.values: -> ::Array[BrandDev::Models::BrandAIQueryParams::DataToExtract::datapoint_type]
         end
+
+        type datapoint_list_type =
+          :string | :text | :number | :date | :boolean | :list | :url | :object
+
+        module DatapointListType
+          extend BrandDev::Internal::Type::Enum
+
+          STRING: :string
+          TEXT: :text
+          NUMBER: :number
+          DATE: :date
+          BOOLEAN: :boolean
+          LIST: :list
+          URL: :url
+          OBJECT: :object
+
+          def self?.values: -> ::Array[BrandDev::Models::BrandAIQueryParams::DataToExtract::datapoint_list_type]
+        end
+
+        type datapoint_object_schema = :string | :number | :date | :boolean
+
+        module DatapointObjectSchema
+          extend BrandDev::Internal::Type::Enum
+
+          STRING: :string
+          NUMBER: :number
+          DATE: :date
+          BOOLEAN: :boolean
+
+          def self?.values: -> ::Array[BrandDev::Models::BrandAIQueryParams::DataToExtract::datapoint_object_schema]
+        end
       end
 
       type specific_pages =
@@ -98,6 +147,7 @@ module BrandDev
           contact_us: bool,
           faq: bool,
           home_page: bool,
+          pricing: bool,
           privacy_policy: bool,
           terms_and_conditions: bool
         }
@@ -127,6 +177,10 @@ module BrandDev
 
         def home_page=: (bool) -> bool
 
+        attr_reader pricing: bool?
+
+        def pricing=: (bool) -> bool
+
         attr_reader privacy_policy: bool?
 
         def privacy_policy=: (bool) -> bool
@@ -142,6 +196,7 @@ module BrandDev
           ?contact_us: bool,
           ?faq: bool,
           ?home_page: bool,
+          ?pricing: bool,
           ?privacy_policy: bool,
           ?terms_and_conditions: bool
         ) -> void
@@ -153,6 +208,7 @@ module BrandDev
           contact_us: bool,
           faq: bool,
           home_page: bool,
+          pricing: bool,
           privacy_policy: bool,
           terms_and_conditions: bool
         }

data/sig/brand_dev/models/brand_ai_query_response.rbs

@@ -69,7 +69,12 @@ module BrandDev
         }
 
         type datapoint_value =
-          String | Float | bool | ::Array[String] | ::Array[Float]
+          String
+          | Float
+          | bool
+          | ::Array[String]
+          | ::Array[Float]
+          | ::Array[top]
 
         module DatapointValue
           extend BrandDev::Internal::Type::Union
@@ -79,6 +84,8 @@ module BrandDev
           StringArray: BrandDev::Internal::Type::Converter
 
           FloatArray: BrandDev::Internal::Type::Converter
+
+          UnionMember5Array: BrandDev::Internal::Type::Converter
         end
       end
     end

data/sig/brand_dev/models/brand_fonts_params.rbs

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

data/sig/brand_dev/models/brand_fonts_response.rbs

@@ -0,0 +1,82 @@
+module BrandDev
+  module Models
+    type brand_fonts_response =
+      {
+        code: Integer,
+        domain: String,
+        fonts: ::Array[BrandDev::Models::BrandFontsResponse::Font],
+        status: String
+      }
+
+    class BrandFontsResponse < BrandDev::Internal::Type::BaseModel
+      attr_accessor code: Integer
+
+      attr_accessor domain: String
+
+      attr_accessor fonts: ::Array[BrandDev::Models::BrandFontsResponse::Font]
+
+      attr_accessor status: String
+
+      def initialize: (
+        code: Integer,
+        domain: String,
+        fonts: ::Array[BrandDev::Models::BrandFontsResponse::Font],
+        status: String
+      ) -> void
+
+      def to_hash: -> {
+        code: Integer,
+        domain: String,
+        fonts: ::Array[BrandDev::Models::BrandFontsResponse::Font],
+        status: String
+      }
+
+      type font =
+        {
+          fallbacks: ::Array[String],
+          font: String,
+          num_elements: Float,
+          num_words: Float,
+          percent_elements: Float,
+          percent_words: Float,
+          uses: ::Array[String]
+        }
+
+      class Font < BrandDev::Internal::Type::BaseModel
+        attr_accessor fallbacks: ::Array[String]
+
+        attr_accessor font: String
+
+        attr_accessor num_elements: Float
+
+        attr_accessor num_words: Float
+
+        attr_accessor percent_elements: Float
+
+        attr_accessor percent_words: Float
+
+        attr_accessor uses: ::Array[String]
+
+        def initialize: (
+          fallbacks: ::Array[String],
+          font: String,
+          num_elements: Float,
+          num_words: Float,
+          percent_elements: Float,
+          percent_words: Float,
+          uses: ::Array[String]
+        ) -> void
+
+        def to_hash: -> {
+          fallbacks: ::Array[String],
+          font: String,
+          num_elements: Float,
+          num_words: Float,
+          percent_elements: Float,
+          percent_words: Float,
+          uses: ::Array[String]
+        }
+      end
+    end
+  end
+end

data/sig/brand_dev/models.rbs

@@ -1,6 +1,8 @@
 module BrandDev
   class BrandAIQueryParams = BrandDev::Models::BrandAIQueryParams
 
+  class BrandFontsParams = BrandDev::Models::BrandFontsParams
+
   class BrandIdentifyFromTransactionParams = BrandDev::Models::BrandIdentifyFromTransactionParams
 
   class BrandPrefetchParams = BrandDev::Models::BrandPrefetchParams

data/sig/brand_dev/resources/brand.rbs

@@ -17,6 +17,12 @@ module BrandDev
         ?request_options: BrandDev::request_opts
       ) -> BrandDev::Models::BrandAIQueryResponse
 
+      def fonts: (
+        domain: String,
+        ?timeout_ms: Integer,
+        ?request_options: BrandDev::request_opts
+      ) -> BrandDev::Models::BrandFontsResponse
+
       def identify_from_transaction: (
         transaction_info: String,
         ?city: String,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: brand.dev
 version: !ruby/object:Gem::Version
-  version: 0.14.0
+  version: 0.16.0
 platform: ruby
 authors:
 - Brand Dev
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-11-24 00:00:00.000000000 Z
+date: 2025-12-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: connection_pool
@@ -56,6 +56,8 @@ files:
 - lib/brand_dev/models.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
+- lib/brand_dev/models/brand_fonts_response.rb
 - lib/brand_dev/models/brand_identify_from_transaction_params.rb
 - lib/brand_dev/models/brand_identify_from_transaction_response.rb
 - lib/brand_dev/models/brand_prefetch_params.rb
@@ -103,6 +105,8 @@ files:
 - rbi/brand_dev/models.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
+- rbi/brand_dev/models/brand_fonts_response.rbi
 - rbi/brand_dev/models/brand_identify_from_transaction_params.rbi
 - rbi/brand_dev/models/brand_identify_from_transaction_response.rbi
 - rbi/brand_dev/models/brand_prefetch_params.rbi
@@ -149,6 +153,8 @@ files:
 - sig/brand_dev/models.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
+- sig/brand_dev/models/brand_fonts_response.rbs
 - sig/brand_dev/models/brand_identify_from_transaction_params.rbs
 - sig/brand_dev/models/brand_identify_from_transaction_response.rbs
 - sig/brand_dev/models/brand_prefetch_params.rbs