Merge pull request #36 from brand-dot-dev/release-please--branches--main--changes--next

release: 0.15.0

Author: YahiaBakour

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.14.0"
+  ".": "0.15.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 12
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/brand-dev%2Fbrand.dev-fff3572a2d6f3a8461fbf52fb74882e1f4ae4a2b31a75673dcae230b336911d2.yml
-openapi_spec_hash: b04ce3c7879b31f1e38cd76372e8e652
-config_hash: 86160e220c81f47769a71c9343e486d8
+configured_endpoints: 13
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/brand-dev%2Fbrand.dev-f69782c2c4296df9db6b41a3a7359a9e4910f59e34901b9f0e8045cec3f9ca69.yml
+openapi_spec_hash: f06c3956a6fc7e57614b120910339747
+config_hash: 6aaf0fe6f8877c9c5d9af95597123cb4

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)

Gemfile.lock

@@ -11,7 +11,7 @@ GIT
 PATH
   remote: .
   specs:
-    brand.dev (0.14.0)
+    brand.dev (0.15.0)
       connection_pool
 
 GEM

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 -->

lib/brand_dev.rb

@@ -54,6 +54,8 @@
 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"

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

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

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

lib/brand_dev/resources/brand.rb

@@ -68,6 +68,34 @@ def ai_query(params)
         )
       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.
       #