brand.dev 0.14.0 → 0.15.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fda4fc2056b5d95165ea2382b716c6289a31530ac84e95ad5184882c77c8b16c
-  data.tar.gz: 446f5ace123e360e235d06acf5f0b0ff012f0b233993afa9bbaba89850bf4707
+  metadata.gz: 3f9ebb12f9033819d1b196df0a48f03924e87fc84ae9cd67d60b834285d58298
+  data.tar.gz: 68aa38b428a97dc6feb04978eda77b985fe10dd2ad2c9eb90d253e8ab51ffb5d
 SHA512:
-  metadata.gz: d4dc5e7f463794528ebb79f2bab854dd169ed4088343568c7c6332c987b4544d9743580aa75c3936159723df6087848de2c3b9d2b8584079d13a684c09492aac
-  data.tar.gz: 8807c59f396a4e6a1e9217dba3c8fcdddc85497917b762a6ed9fc2ece4ba721885cf9f6c8e280aade89c3d5ad4e6fe75bf1df5cc9045843813e6eb9f585203f3
+  metadata.gz: c4e90eac0c02156ab50c09d4954044c26b3732e4c6176e0e7d3b62e8287963d728f200b8bc37b6b6de7c1254b10178c6855624663a252c1663ca375341ba20a1
+  data.tar.gz: 1982d5065604c5eba9dcc4e9de75bbecb7ed3b0436d671ab2132ac2fac751a589db33831391077664166e84bd84ca1273e1f0c0a075c34311341387768e0a45e

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 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.15.0"
 ```
 
 <!-- x-release-please-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.15.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_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_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.15.0
 platform: ruby
 authors:
 - Brand Dev
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-11-24 00:00:00.000000000 Z
+date: 2025-11-29 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